.png)
Set-RMSTrustedPublishingDomain
Applies to: Exchange Online
Topic Last Modified: 2012-09-18
This cmdlet is available only in the cloud-based service.
Use the Set-RMSTrustedPublishingDomain cmdlet to configure a trusted publishing domain (TPD) in your organization.
For information about the parameter sets in the Syntax section below, see Syntax.
Set-RMSTrustedPublishingDomain -Identity <RmsTrustedPublishingDomainIdParameter> [-Confirm [<SwitchParameter>]] [-Default <SwitchParameter>] [-DomainController <Fqdn>] [-ExtranetCertificationUrl <Uri>] [-ExtranetLicensingUrl <Uri>] [-IntranetCertificationUrl <Uri>] [-IntranetLicensingUrl <Uri>] [-Name <String>] [-WhatIf [<SwitchParameter>]]
This example makes the following changes to the existing TPD Contoso TPD:
-
Sets Contoso TPD as the default TPD for the organization.
-
Sets the external licensing URL to https://rms.contoso.com/_wmcs/licensing.
-
Sets the external certification URL to https://rms.contoso.com/_wmcs/certification/servercertification.asmx
Set-RMSTrustedPublishingDomain "Contoso TPD" -Default -ExtranetLicensingUrl https://rms.contoso.com/_wmcs/licensing -ExtranetCertificationUrl https://rms.contoso.com/_wmcs/certification/servercertification.asmx
A TPD contains the settings needed to use RMS features in your organization. For example, users can apply RMS templates to email messages.
| Parameter | Required | Type | Description |
|---|---|---|---|
| Identity | Required | Microsoft.Exchange.Configuration.Tasks.RmsTrustedPublishingDomainIdParameter | The Identity parameter specifies the TPD. You can use any value that uniquely identifies the TPD, for example:
|
| Confirm | Optional | System.Management.Automation.SwitchParameter | The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch. |
| Default | Optional | System.Management.Automation.SwitchParameter | The Default parameter specifies this is the default TPD. The default TPD displays RMS templates and provides rights protection to all new content. There can be only one default TPD in an organization. |
| DomainController | Optional | Microsoft.Exchange.Data.Fqdn | This parameter is reserved for internal Microsoft use. |
| ExtranetCertificationUrl | Optional | System.Uri | The ExtranetCertificationUrl parameter specifies the external certification URL of the on-premises AD RMS server that's stamped into the Rights Account Certificate (RAC). The RAC establishes a user's identity in the AD RMS system and is used to decrypt content. |
| ExtranetLicensingUrl | Optional | System.Uri | The ExtranetLicensingUrl parameter specifies the external licensing URL of the on-premises AD RMS server that's stamped into the publishing license. The publishing license specifies the users that can open the rights-protected content, under which conditions the content may be opened by the user, and the rights that each user will have to the rights-protected content. |
| IntranetCertificationUrl | Optional | System.Uri | The IntranetCertificationUrl parameter specifies the internal certification URL of the on-premises AD RMS server that's stamped into the RAC. The RAC establishes a user's identity in the AD RMS system and is used to decrypt content. |
| IntranetLicensingUrl | Optional | System.Uri | The IntranetLicensingUrl parameter specifies the internal licensing URL of the on-premises AD RMS server that's stamped into the publishing license. The publishing license specifies the users that can open the rights-protected content, under which conditions the content may be opened by the user, and the rights that each user will have to the rights-protected content. |
| Name | Optional | System.String | The Name parameter specifies the name of the TPD. |
| WhatIf | Optional | System.Management.Automation.SwitchParameter | The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch. |
To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.
To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.
