Set-AdfsClient

Windows Server 2012 R2 and Windows 8.1

Set-AdfsClient

Modifies registration settings for an OAuth 2.0 client registered with AD FS.

構文

Parameter Set: Name
Set-AdfsClient [-TargetName] <String> [-ClientId <String> ] [-Description <String> ] [-Name <String> ] [-PassThru] [-RedirectUri <Uri[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ClientId
Set-AdfsClient [-TargetClientId] <String> [-ClientId <String> ] [-Description <String> ] [-Name <String> ] [-PassThru] [-RedirectUri <Uri[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject
Set-AdfsClient [-TargetClient] <AdfsClient> [-ClientId <String> ] [-Description <String> ] [-Name <String> ] [-PassThru] [-RedirectUri <Uri[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




詳細説明

The Set-AdfsClient cmdlet modifies registration settings for an OAuth 2.0 client registered with Active Directory フェデレーション サービス (AD FS). Use this cmdlet to modify the settings, including the client identifier, redirection URI, name, or description of the OAuth 2.0 client. You can also use this cmdlet to register additional redirection URIs for the OAuth 2.0 client.

パラメーター

-ClientId<String>

Specifies a string. The cmdlet modifies the OAuth 2.0 client registration information with the identifier that you specify.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Description<String>

Specifies a description. The cmdlet modifies the OAuth 2.0 client registration information with the description that you specify.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Name<String>

Specifies a name. The cmdlet modifies the OAuth 2.0 client registration information with the name that you specify.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-RedirectUri<Uri[]>

Specifies one or more redirection URIs. The cmdlet modifies the OAuth 2.0 client registration information with the redirection URIs that you specify.

The OAuth 2.0 client uses the redirection URI when the client requests authorization to access a resource secured by AD FS. You may register multiple redirection URIs for a single client identifier. The redirection URI must be a valid URI.

The redirection URI specified by the client must already be registered with AD FS and must correspond to the client identifier for that OAuth 2.0 client, in order for the client to be authorized to access the resource. If the client ID and redirection URI correspond to a pre-registered OAuth 2.0 client and the resource owner authorized access by providing their credentials, AD FS will deliver the authorization code or access token by redirecting the client's user-agent back to this redirection URI.

Ensure that the value of the RedirectUri parameter matches exactly the redirection URI that will be specified by the OAuth 2.0 client when requesting authorization, including trailing slashes (/), if required. Use more secure schemes, such as https, when you specify a redirection URI.

For Windows Store applications that authenticate using the Windows Web Authentication Broker, use the 'ms-app://' scheme when registering a redirect URI. For example, ms-app://s-1-15-2-1101140336-4090662585-1905587327-262951538-2732256205-1306401843-4235927180/ is a redirect URI for a Windows Store application. If you are developing a Windows Store application, you can obtain the redirect URI for your application using the following code fragment:

Uri redirectURI = Windows.Security.Authentication.Web.WebAuthenticationBroker.GetCurrentApplicationCallbackUri();


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TargetClient<AdfsClient>

Specifies the registered OAuth 2.0 client to modify.


エイリアス

なし

必須?

true

位置は?

1

既定値

なし

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-TargetClientId<String>

Specifies the client identifier for the registered OAuth 2.0 client to modify.


エイリアス

なし

必須?

true

位置は?

1

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TargetName<String>

Specifies the name of the registered OAuth 2.0 client to modify.


エイリアス

なし

必須?

true

位置は?

1

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。


必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。


必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • System.Object

Example 1: Modify the redirection URI

This command changes the redirection URI for the OAuth 2.0 client currently registered with AD FS with the name Payroll Application.


PS C:\> Set-AdfsClient -TargetName "Payroll Application" -RedirectUri "https://localhost"

Example 2: Rename an OAuth 2.0 client

This command renames the OAuth 2.0 client currently registered with AD FS with the name Payroll Application.


PS C:\> Set-AdfsClient -TargetName "Payroll Application" -Name "Payroll Application v2"

関連トピック

コミュニティの追加

追加
表示: