Update-ADRMS
Update-ADRMS is accessible with the help of ADRMS module. To install ADRMS on your system please refer to this ADRMS.
Synopsis
Updates an existing deployment of AD RMS Server.
Description
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 AD RMS cryptographic mode on a server.
Parameters
-Confirm <>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
-Credential <pscredential>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
-Force <>
Required? false
Position? 3
Default value
Accept pipeline input? false
Accept wildcard characters?
-NewCspName <string>
Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters?
-PrivateKeyPassword <securestring>
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters?
-ServiceAccount <pscredential>
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters?
-UpdateCryptographicModeOnly <>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
-WhatIf <>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
Syntax
Update-ADRMS [-ServiceAccount] <PSCredential> [[-PrivateKeyPassword] <SecureString>] [[-NewCspName] <String>] [-UpdateCryptographicModeOnly] [-Credential <PSCredential>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
—————–Example 1—————–
Upgrade an AD RMS server
PS C:\> $mySecureStringPassword = ConvertTo-SecureString -String <password> -AsPlainText -Force PS C:\> $myCred = Get-Credential PS C:\> Update-ADRMS -PrivateKeyPassword $mySecureStringPassword -ServiceAccount $myCred
This example upgrades an AD RMS 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 AD RMS Service Account credentials (username and password) that are also required to upgrade AD RMS.
—————–Example 2—————–
Upgrade an AD RMS server to cryptographic mode 2
PS C:\> $myCred = Get-Credential PS C:\> Update-ADRMS -UpdateCryptographicModeOnly -ServiceAccount $myCred
This example updates an AD RMS server that is using a cluster key password to cryptographic mode 2. The Get-Credential command will launch a popup dialog to enter the AD RMS 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.
You can check the Version, CommandType and Source of this cmdlet by giving below command.
Get-Command Update-ADRMS