Uninstall-ADRMS
Removes configuration for an existing deployment of AD RMS Server.
Syntax
Uninstall-ADRMS
[-ADFSOnly]
[-Credential <PSCredential>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Uninstall-ADRMS cmdlet removes configuration for the Active Directory Rights Management Services (AD RMS) server role and, if appropriate, role services that were installed with AD RMS. To remove configuration for Identity Federation Support only, specify the ADFSOnly parameter.
Examples
-------------------------- EXAMPLE 1 --------------------------
C:\PS>Uninstall-ADRMS -Force
Description
This command removes the rms_2 configuration on this computer. For more information on using this cmdlet, see http://go.microsoft.com/fwlink/?LinkId=136806
-------------------------- EXAMPLE 2 --------------------------
C:\PS>Uninstall-ADRMS -ADFSOnly -Force
Description
This command removes the Identity Federation Support configuration on this computer. For more information on using this cmdlet, see http://go.microsoft.com/fwlink/?LinkId=136806
Parameters
-ADFSOnly
Removes configuration support for Active Directory Federated Services (AD FS) from this computer, but does not otherwise change the AD RMS configuration.
Type: | SwitchParameter |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Specifies user credentials to use for the configuration process. If this parameter is specified, you will be prompted to enter credentials. This parameter operates in a similar manner to the RunAs command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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).
Type: | SwitchParameter |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
SwitchParameter, PSCredential
Notes
- To totally remove the rms_2 role from the system, the Remove-WindowsFeature cmdlet must be run after this cmdlet is used. The command to do so is the Remove-WindowsFeature ADRMS -IncludeManagementTools command.
Related Links
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for