Export-RmsTPD
Export-RmsTPD is accessible with the help of ADRMSAdmin module. To install ADRMSAdmin on your system please refer to this ADRMSAdmin.
Synopsis
Exports a TPD in AD RMS.
Description
The Export-RmsTPD cmdlet exports a trusted publishing domain (TPD) in Active Directory Rights Management Services (AD RMS) to a file.
To perform the export, set the SavedFilePath parameter to the export file path, and then set the Path parameter to the AD RMS provider path <PSDrive>:\TrustPolicy\TrustedPublishingDomain\<TPD_ID>
where <PSDrive>
is the provider drive ID and <TPD_ID>
is the ID of the TPD that you want to export.
Parameters
-Confirm <>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
-Force <>
Required? false
Position? Named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
-Password <securestring>
Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
-Path <string[]>
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters?
-SavedFile <string[]>
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
-V1Compatible <>
Required? false
Position? Named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters?
-WhatIf <>
Required? false
Position? Named
Default value
Accept pipeline input? false
Accept wildcard characters?
Syntax
Export-RmsTPD [-SavedFile] <String[]> [-Password] <SecureString> [-V1Compatible] [-Force] [-Path] <String[]> [-WhatIf] [-Confirm] [<CommonParameters>]
——————-Example 1——————-
Export a TPD by ID
PS C:\> Export-RmsTPD -Path “.\100” -SavedFile “c:\ADRMS\test.xml”
This command exports the TPD with the ID of 100 to the file C:\ADRMS\test.xml. Because the Password parameter is not specified, the command prompts for the password.
——————-Example 2——————-
Read a password and use it to export a TPD
PS C:\> $pswd = Read-Host -AsSecureString
PS C:\> Export-RmsTPD -Path “100” -SavedFile “c:\ADRMS\test.xml” -Password $pswd
The first command prompts for a password and saves it in the variable $pswd. The variable is then passed to the Export-RmsTPD command as the Password parameter. Note that the Export-RmsTPD command prompts for a confirmation password that must match the password stored in the $pswd variable.
——————-Example 3——————-
Export a TPD without prompting for the password
PS C:\> $pswd=Read-Host -AsSecureString
PS C:\> Export-RmsTPD -Path “100” -SavedFile “c:\ADRMS\test.xml” -Password $pswd -Force
The first command prompts for a password and saves it in the variable $pswd. The variable is then passed to the Export-RmsTPD command as the Password parameter. Because the Force parameter is specified, the Export-RmsTPD command does not prompt for a confirmation password.
You can check the Version, CommandType and Source of this cmdlet by giving below command.
Get-Command Export-RmsTPD
You can also read about
- Using Windows PowerShell with AD RMS
- Export-RmsTUD
- Import-RmsTPD
- Import-RmsTUD