Set-RmsSvcAccount

[アーティクル]
11/16/2015

Set-RmsSvcAccount

Sets the service account for an Active Directory Rights Management Services (AD RMS) cluster.

構文

Parameter Set: Default
Set-RmsSvcAccount [-Path] <String[]> [-Credential] <PSCredential> [-Force] [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-RmsSvcAccount cmdlet sets the service account of an Active Directory Rights Management Services (AD RMS) cluster.

To specify the service account, set the Credential parameter to the service account credentials, and then set the Path parameter to “<PSDrive>:\” where <PSDrive> is the AD RMS provider drive ID.

パラメーター

-Credential<PSCredential>

Specifies a user name and password as a PSCredential object.

エイリアス	なし
必須?	true
位置は?	2
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Force

Overrides restrictions that prevent the command from succeeding, just so the changes do not compromise security.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	true (ByValue, ByPropertyName)
ワイルドカード文字を許可する	false

-PassThru

Passes the object created by this cmdlet through the pipeline. By default, this cmdlet does not pass any objects through the pipeline.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	true (ByValue, ByPropertyName)
ワイルドカード文字を許可する	false

-Path<String[]>

Specifies a provider drive and path or relative path on the current drive. This parameter is required. Use a dot (.) to specify the current location. This parameter does not accept wildcards and has no default value.

エイリアス	なし
必須?	true
位置は?	1
既定値	String.empty
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Confirm

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

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WhatIf

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

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

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

入力

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

出力

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

PSCredential

例

-------------- EXAMPLE 1 --------------

This command changes the AD RMS service account. Because the Credential parameter is not used, the Set-RmsSvcAccount cmdlet prompts for the user name and password of the new service account.

C:\PS>Set-RmsSvcAccount -Path .

-------------- EXAMPLE 2 --------------

This command changes the AD RMS service account. Because the Credential specifies the domain and user name of the account, the Set-RmsSvcAccount cmdlet prompts for the password of the new service account.

C:\PS>Set-RmsSvcAccount -Path . -Force -PassThru -Credential ITDOMAIN\adrmssvc

-------------- EXAMPLE 3 --------------

This command uses the Get-Credential cmdlet to prompt for the password for the ITDOMAIN\adrmsvc account and then stores the account credentials securely in a variable, which is then passed to the Set-RmsSvcAccount cmdlet.

C:\PS>$userAccount = Get-Credential ITDOMAIN\adrmssvc
Set-RmsSvcAccount -Path . -Force -PassThru -Credential $userAccount

Set-RmsSvcAccount