< Back
Set-AadrmMigrationUrl
Post
NAME Set-AadrmMigrationUrl
SYNOPSIS
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
(https://docs.microsoft.com/information- ... tenant-key).
PARAMETERS
-Domain <String>
Specifies a URL for the domain to migrate.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Indicates that the cmdlet sets the value of the migration URL even if there is an existing migration URL.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
---------------- Example 1: Set a migration URL ----------------
PS C:\\>Set-AadrmMigrationUrl -Domain "aadrm.online.contoso.com"
This command sets a migration URL for Rights Management.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=400622
Get-AadrmMigrationUrl
Microsoft-managed: Tenant key lifecycle operations
https://docs.microsoft.com/information- ... tenant-key
SYNOPSIS
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
(https://docs.microsoft.com/information- ... tenant-key).
PARAMETERS
-Domain <String>
Specifies a URL for the domain to migrate.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Indicates that the cmdlet sets the value of the migration URL even if there is an existing migration URL.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
---------------- Example 1: Set a migration URL ----------------
PS C:\\>Set-AadrmMigrationUrl -Domain "aadrm.online.contoso.com"
This command sets a migration URL for Rights Management.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=400622
Get-AadrmMigrationUrl
Microsoft-managed: Tenant key lifecycle operations
https://docs.microsoft.com/information- ... tenant-key