Export-RmsTPD

Export-RmsTPD

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

構文

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

詳細説明

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.

パラメーター

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

-Password<SecureString>

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.

-Path<String[]>

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.

-SavedFile<String[]>

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

-V1Compatible

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

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

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

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.

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

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

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.

C:\PS>$pswd=Read-Host -AsSecureString
Export-RmsTPD -Path 100 -SavedFile c:\temp\test.xml -Password $pswd

-------------- EXAMPLE 3 --------------

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.

C:\PS>$pswd=Read-Host -AsSecureString
Export-RmsTPD -Path 100 -SavedFile c:\temp\test.xml -Password $pswd -Force

関連トピック

Export-RmsTUD

Import-RmsTPD

Import-RmsTUD

Read-Host

Using Windows PowerShell with AD RMS