Import-RmsTUD

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

Syntax 

Import-RmsTUD
      [-DisplayName] <String>
      [-SourceFile] <String>
      [-TrustADFederatedUser]
      [-PassThru]
      [-Path] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-RmsTUD
      [-WindowsLiveId]
      [-PassThru]
      [-Path] <String[]>
      [-WhatIf]
      [-Confirm]
      [<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