Edit

Import-RmsTUD

  • Reference
Module:
ADRMSAdmin

Imports a trusted user domain (TUDs) from a file in Active Directory Rights Management Services (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 enterprise TUDs, specify the DisplayName and SourceFile parameters and set the Path parameter to the AD RMS provider drive subpath "<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 subpath "<PSDrive>:\TrustPolicy\TrustedUserDomain"

Examples

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

C:\PS>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 --------------

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

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

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

-DisplayName

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

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

-PassThru

Passes the object created by this cmdlet through the pipeline. By default, this cmdlet does not pass any objects through the pipeline.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-SourceFile

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

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

-TrustADFederatedUser

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

Type:SwitchParameter
Position:3
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

-WindowsLiveId

Specifies to trust Microsoft account IDs.

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

Outputs

Microsoft.RightsManagementServices.PowerShell.TrustedUserDomainImportedItem