Update-ADRMS
Update-ADRMS
Updates an existing deployment of Server.
構文
Parameter Set: Default
Update-ADRMS [-ServiceAccount] <PSCredential> [[-PrivateKeyPassword] <SecureString> ] [[-NewCspName] <String> ] [[-Force]] [-Credential <PSCredential> ] [-UpdateCryptographicModeOnly] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Update-ADRMS cmdlet updates the Active Directory Rights Management Services (AD RMS) server role on a server that has been upgraded to this version of Windows. The cmdlet can also be used to update the cryptographic mode on a server.
パラメーター
-Credential<PSCredential>
Specifies user credentials to use for the update process. If this parameter is specified, you will be prompted to enter credentials. This parameter operates in a similar manner to the RunAs command.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Force
Forces completion of the command by overriding restrictions that would prevent it from succeeding (so long as a the changes made do not compromise security).
エイリアス |
なし |
必須? |
false |
位置は? |
4 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-NewCspName<String>
Specifies the new name of the cryptographic service provider (CSP) to use for storing the private key of the server. This parameter is used in combination with the –UpdateCryptographicMode parameter for servers that are using CSP key storage.
エイリアス |
なし |
必須? |
false |
位置は? |
3 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PrivateKeyPassword<SecureString>
Specifies the password for the AD RMS centrally managed key.
エイリアス |
なし |
必須? |
false |
位置は? |
2 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ServiceAccount<PSCredential>
Specifies the identity of the domain account that is used for the service account.
エイリアス |
なし |
必須? |
true |
位置は? |
1 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-UpdateCryptographicModeOnly
If set, indicates that only the cryptographic mode of the server is to be updated. To update the cryptographic mode of an server, you must be logged in with an account that has membership in the local Enterprise Administrators Group on that server. If the server is using CSP key storage, the –NewCspName parameter should also be specified.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
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)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
- SwitchParameter, string, PSCredential, SecureString
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
Upgrades an server and cluster that is using a cluster key password. The password must be specified securely as console input. The Get-Credential cmdlet will launch a popup dialog to enter the Service Account credentials (username and password) that are also required to upgrade .
C:\PS>$mySecureStringPassword = ConvertTo-SecureString –String <password> -AsPlainText -Force
$myCred = Get-Credential
Update-ADRMS -PrivateKeyPassword $mySecureStringPassword -ServiceAccount $myCred
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
Updates an server that is using a cluster key password to cryptographic mode 2. The Get-Credential command will launch a popup dialog to enter the Service Account credentials (username and password) which are required for this update. The cluster key password is not required; but if the server is using CSP key storage, the –NewCspName parameter must be included.
C:\PS>$myCred = Get-Credential
Update-ADRMS -UpdateCryptographicModeOnly -ServiceAccount $myCred