Table of contents
TOC
Collapse the table of content
Expand the table of content

Uninstall-ADRMS

Last Updated: 3/26/2017

SYNOPSIS

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: Remove the AD RMS configuration

PS C:\> Uninstall-ADRMS -Force

This command removes the AD RMS configuration on this computer. For more information on using this cmdlet, see Using Windows PowerShell with AD RMS.

Example 2: removes the Identity Federation Support configuration

PS C:\> Uninstall-ADRMS -ADFSOnly -Force

This command removes the Identity Federation Support configuration on this computer.

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
Parameter Sets: (All)
Aliases: 

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: 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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: 

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

SwitchParameter, PSCredential

OUTPUTS

NOTES

  • To totally remove the AD RMS 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.

Install-ADRMS

Update-ADRMS

© 2017 Microsoft