Edit

Share via


Install-RmsMfgSupport

Adds Microsoft Federation Gateway support to an AD RMS server.

Syntax

Default (Default)

Install-RmsMfgSupport
    [-Force]
    [-FederationUrl <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Install-RmsMfgSupport cmdlet adds Microsoft Federation Gateway support to an Active Directory Rights Management Services (AD RMS) server.

Examples

Example 1: Add Microsoft Federation Gateway support

PS C:\> Install-RmsMfgSupport

This command adds Microsoft Federation Gateway support to an AD RMS server.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FederationUrl

Specifies the uniform resource locator (URL) for the AD RMS server to use to connect to the Microsoft Federation Gateway. If this parameter is not specified, AD RMS connects to the Microsoft Federation Gateway using the default value.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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

Inputs

None

Outputs

None

Notes

  • Before adding Microsoft Federation Gateway Support, it is very important that you back up the AD RMS configuration database.
  • Do not run this command if the AD RMS snap-in is open in the Microsoft Management Console (MMC). If you do, the command will not respond until you close the AD RMS MMC snap-in.
  • Before uninstalling Service Pack 1 for Windows® 7, you must remove Microsoft Federation Gateway Support from the AD RMS cluster by running the Uninstall-RmsMfgSupport cmdlet. Failure to do so may cause an inconsistent configuration of your AD RMS cluster.