編集

次の方法で共有


Set-AdfsRelyingPartyWebTheme

Applies a web theme to a relying party.

Syntax

IdentifierName (Default)

Set-AdfsRelyingPartyWebTheme
    [-TargetRelyingPartyName] <String>
    [-StyleSheet <Hashtable[]>]
    [-RTLStyleSheetPath <String>]
    [-OnLoadScriptPath <String>]
    [-Logo <Hashtable[]>]
    [-Illustration <Hashtable[]>]
    [-SourceWebThemeName <String>]
    [-SourceRelyingPartyName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

IdentifierObject

Set-AdfsRelyingPartyWebTheme
    [-TargetRelyingPartyWebTheme] <AdfsRelyingPartyWebTheme>
    [-StyleSheet <Hashtable[]>]
    [-RTLStyleSheetPath <String>]
    [-OnLoadScriptPath <String>]
    [-Logo <Hashtable[]>]
    [-Illustration <Hashtable[]>]
    [-SourceWebThemeName <String>]
    [-SourceRelyingPartyName <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Set-AdfsRelyingPartyWebTheme cmdlet applies a web theme to a relying party. A web theme includes logo, illustration, stylesheets, and custom onload.js files.

Examples

Example 1: Create a custom theme and assign it to the Office 365 relying party trust

PS C:\> New-AdfsWebTheme -Name "Office365Theme" -SourceName "default"
PS C:\> Set-AdfsWebTheme -TargetName "Office365Theme" -Illustration @{Path="C:\localpath\illustration22.jpg"}
PS C:\> Set-AdfsRelyingPartyWebTheme -TargetRelyingPartyName "Microsoft Office 365 Identity Platform" -SourceWebThemeName "Office365Theme"

The first command creates an AD FS web theme by using the New-AdfsWebTheme cmdlet. The theme is named Office365Theme.

The second command modifies Office365Theme by using the Set-AdfsWebTheme cmdlet.

The final command assigns the custom theme to the Office 365 relying party trust.

Example 2: Create an advanced per application custom theme and assign it to a relying party

PS C:\> New-AdfsWebTheme -Name "AppSpecificTheme" -SourceName "default"
PS C:\> Export-AdfsWebTheme -Name "AppSpecificTheme" -DirectoryPath "C:\AppSpecificTheme"
PS C:\> Set-AdfsWebTheme -TargetName "AppSpecificTheme" -AdditionalFileResource @{Uri='/adfs/portal/script/onload.js';Path="C:\AppSpecificTheme\script\onload.js"}
PS C:\> Set-AdfsRelyingPartyWebTheme -TargetRelyingPartyName "urn:app1" -SourceWebThemeName "AppSpecificTheme"

The first command creates a theme as a copy of the default global theme in AD FS by using New-AdfsWebTheme.

The second command exports the theme for customization by using the Export-AdfsWebTheme cmdlet.

The third command customizes the theme by specifying files by using Set-AdfsWebTheme.

The final command applies the customized theme to a relying party.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Illustration

Specifies an illustration as a hash table.

Parameter properties

Type:

Hashtable[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

Specifies a logo as a hash table.

Parameter properties

Type:

Hashtable[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OnLoadScriptPath

Specifies the path of an onload script.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RTLStyleSheetPath

Specifies the path of the RTL style sheet.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SourceRelyingPartyName

Specifies the name of the source relying party.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SourceWebThemeName

Specifies the name of the source web theme.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StyleSheet

Specifies a style sheet as a hash table.

Parameter properties

Type:

Hashtable[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-TargetRelyingPartyName

Specifies the name of the target relying party.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Name

Parameter sets

IdentifierName
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-TargetRelyingPartyWebTheme

Specifies the name of the target web theme.

Parameter properties

Type:AdfsRelyingPartyWebTheme
Default value:None
Supports wildcards:False
DontShow:False
Aliases:TargetWebTheme

Parameter sets

IdentifierObject
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.