Import-RmsTUD

Imports a TUD from a file in AD RMS or specifies to trust Microsoft account IDs.

Syntax

Import-RmsTUD
      [-Path] <String[]>
      [-DisplayName] <String>
      [-SourceFile] <String>
      [-TrustADFederatedUser]
      [-Confirm]
      [-PassThru]
      [-WhatIf]
      [<CommonParameters>]
Import-RmsTUD
      [-Path] <String[]>
      [-WindowsLiveId]
      [-Confirm]
      [-PassThru]
      [-WhatIf]
      [<CommonParameters>]

Description

The Import-RmsTUD cmdlet imports an enterprise trusted user domain (TUD) from a file in Active Directory Rights Management Services (AD RMS) or it specifies to trust a Microsoft account ID.

To perform the import of enterprise TUDs, specify the DisplayName and SourceFile parameters and set the Path parameter to the AD RMS provider drive folder <PSDrive>:\TrustPolicy\TrustedUserDomain where <PSDrive> is the provider drive ID.

To trust a Microsoft account ID, specify the WindowsLiveID parameter, and set the Path parameter to the AD RMS provider drive folder <PSDrive>:\TrustPolicy\TrustedUserDomain.

Examples

Example 1: Import a TUD and assign it a name

PS C:\> Import-TUD -Path "." -DisplayName "Fabrikam" -SourceFile "c:\transfer\fabrikam.xml"

This command imports the TUD information stored in the specified file and assigns the name Fabrikam to the TUD.

Example 2: Configure a TUD to trust Microsoft account IDs

PS C:\> Import-RmsTUD -Path "." -WindowsLiveId

This command configures the AD RMS cluster to trust Microsoft account IDs.

Required Parameters

-DisplayName

Specifies the name that will be used to identify the domain being imported.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
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
Accept pipeline input:False
Accept wildcard characters:False
-SourceFile

Specifies the path to the file that contains the domain information to import.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-WindowsLiveId

Indicates to trust Microsoft account IDs.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
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
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-TrustADFederatedUser

Specifies to trust Active Directory Federation Services (ADFS) users.

Type:SwitchParameter
Position:3
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
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

Outputs

Microsoft.RightsManagementServices.PowerShell.TrustedUserDomainImportedItem