Edit

Export-RmsTPD

  • Reference
Module:
ADRMSAdmin

Exports a trusted publishing domain (TPD) in Active Directory Rights Management Services (AD RMS) to a file.

Syntax

Export-RmsTPD
      [-SavedFile] <String[]>
      [-Password] <SecureString>
      [-V1Compatible]
      [-Force]
      [-Path] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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 subpath "<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.

Examples

-------------- EXAMPLE 1 --------------

C:\PS>Export-RmsTPD -Path .\100 -SavedFile c:\temp\test.xml

This command exports the TPD with the ID of 100 to the file c:\temp\test.xml. Because the -Password parameter is not used, the command prompts for the password.

-------------- EXAMPLE 2 --------------

C:\PS>$pswd=Read-Host -AsSecureString
Export-RmsTPD -Path 100 -SavedFile c:\temp\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 --------------

C:\PS>$pswd=Read-Host -AsSecureString
Export-RmsTPD -Path 100 -SavedFile c:\temp\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 was used, the Export-RmsTPD command does not prompt for a confirmation password.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-Force

Overrides restrictions that prevent the command from succeeding, just so the changes do not compromise security. For example, Force will override the read-only attribute or create directories to complete a file path, but it will not attempt to change file permissions.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Password

Specifies a password as a SecureString object. To create a SecureString object that contains a password, use the Read-Host cmdlet and specify the AsSecureString parameter.

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifies a provider drive and path or relative path on the current drive. This parameter is required. Use a dot (.) to specify the current location. This parameter does not accept wildcards and has no default value.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SavedFile

Specifies the full path and filename of the file that receives the exported content.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-V1Compatible

Allows the trusted publishing domain to be imported to Windows Rights Management Services (RMS) 1.0.

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