Set-​Aadrm​Migration​Url

Sets the migration URL for Rights Management.

Syntax

Set-AadrmMigrationUrl
   -Domain <String>
   [-Force]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

The Set-AadrmMigrationUrl cmdlet sets the migration URL for Azure Rights Management.

You must use PowerShell to set the migration URL; you cannot do this action by using a management portal.

Migration URLs let you migrate from Azure Rights Management to a supported on-premises Rights Management server. Use this migration technique if you need indefinite access to content that has been previously protected by using Azure Rights Management and you have decided to no longer use Azure Rights Management.

In addition to setting this migration URL for clients, you must export your keys and policies from the cloud service in the form of a trusted publishing domain (TPD file) and import them into an on-premises Rights Management server. For more information, see the instructions for exporting your tenant key in Microsoft-managed: Tenant key lifecycle operations.

Examples

Example 1: Set a migration URL

PS C:\>Set-AadrmMigrationUrl -Domain "aadrm.online.contoso.com"

This command sets a migration URL for Rights Management.

Required Parameters

-Domain

Specifies a URL for the domain to migrate.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Force

Indicates that the cmdlet sets the value of the migration URL even if there is an existing migration URL.

Type:SwitchParameter
Position:Named
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
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False