Import-RMSTrustedPublishingDomain

 

S’applique à :Exchange Online

Dernière rubrique modifiée :2016-04-05

Cette cmdlet est disponible uniquement dans le service en nuage.

La cmdlet Import-RMSTrustedPublishingDomain permet d'importer un domaine de publication approuvé à partir d'un serveur local exécutant Active Directory Rights Management Services (AD RMS) ou à partir de RMS Online dans votre organisation en nuage.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Import-RMSTrustedPublishingDomain -ExtranetLicensingUrl <Uri> -FileData <Byte[]> -IntranetLicensingUrl <Uri> -Password <SecureString> <COMMON PARAMETERS>

Import-RMSTrustedPublishingDomain -FileData <Byte[]> -Password <SecureString> [-RefreshTemplates <SwitchParameter>] <COMMON PARAMETERS>

Import-RMSTrustedPublishingDomain -ExtranetLicensingUrl <Uri> -FileData <Byte[]> -IntranetLicensingUrl <Uri> -Password <SecureString> [-ExtranetCertificationUrl <Uri>] [-IntranetCertificationUrl <Uri>] <COMMON PARAMETERS>

Import-RMSTrustedPublishingDomain -RMSOnline <SwitchParameter> [-RefreshTemplates <SwitchParameter>] [-RMSOnlineAuthCertSubjectNameOverride <String>] [-RMSOnlineOrgOverride <Guid>] <COMMON PARAMETERS>

Import-RMSTrustedPublishingDomain -RMSOnlineConfig <Byte[]> -RMSOnlineKeys <Hashtable> [-RMSOnlineAuthorTest <Hashtable>] <COMMON PARAMETERS>

COMMON PARAMETERS: -Name <String> [-Confirm [<SwitchParameter>]] [-Default <SwitchParameter>] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Cet exemple importe un domaine de publication approuvé depuis un serveur AD RMS vers une organisation en nuage. Le domaine de publication approuvé utilise les valeurs suivantes :

  • Chemin d'accès au fichier XML exporté   C:\My Documents\Contoso.xml

  • Mot de passe du fichier XML exporté   Pa$$word1

  • URL d'attribution de licences externe   https://rms.contoso.com/_wmcs/licensing

  • URL d'attribution de licences interne   https://RMS01/_wmcs/licensing

  • Nom de domaine de publication approuvé   Contoso TPD

Import-RMSTrustedPublishingDomain -Name "Contoso TPD" -FileData $([byte[]](Get-Content -Encoding byte -Path "C:\My Documents\Contoso.xml" -ReadCount 0)) -Password (ConvertTo-SecureString -String 'Pa$$word1' -AstPlainText -Force)-ExtranetLicensingUrl https://rms.contoso.com/_wmcs/licensing -IntranetLicensingUrl https://RMS01/_wmcs/licensing

Un domaine de publication approuvé contient les paramètres nécessaires à l'utilisation des fonctionnalités RMS dans votre organisation. Par exemple, les utilisateurs peuvent appliquer des modèles RMS à des messages électroniques. Après avoir exporté le domaine de publication approuvé dans un fichier XML à partir d'un serveur AD RMS, vous pouvez importer le fichier XML dans votre organisation en nuage.

noteRemarque :
Vous pouvez importer les domaines de publication approuvés depuis les serveurs AD RMS s'exécutant sur toutes les versions de Windows Server 2008 et Windows Server 2003.

Si la valeur du paramètre InternalLicensingEnabled est définie sur $true sur la cmdlet Set-IRMConfiguration, tous les domaines de publication approuvés exigent une clé privée. Si la valeur du paramètre InternalLicensingEnabled est définie sur $false, les domaines de publication approuvés n'exigent pas de clé privée. En revanche, la seule fonctionnalité RMS disponible pour l'organisation est les règles de protection Outlook. En règle générale, des domaines de publication approuvés sans clés privées sont créés lorsque le serveur AD RMS fait appel à un fournisseur de services de chiffrement pour matériel ou un fournisseur de services de chiffrement personnalisé.

 

Paramètre Obligatoire Type Description

ExtranetLicensingUrl

Obligatoire

System.Uri

Le paramètre ExtranetLicensingUrl spécifie l'URL d'attribution de licences externe du serveur AD RMS local qui est inscrite dans la licence de publication. La licence de publication précise les utilisateurs qui peuvent ouvrir du contenu, les conditions sous lesquelles ce contenu peut être ouvert par l'utilisateur et les droits dont bénéficie chaque utilisateur pour ce contenu protégé.

Par défaut, la valeur du paramètre ExtranetLicensingUrl est https://<FQDN>/_wmcs/licensing.

FileData

Obligatoire

System.Byte[]

Le paramètre FileData spécifie le fichier XML à importer. Le fichier XML renferme le domaine de publication approuvé que vous avez exporté à partir du serveur AD RMS local.

Vous devez lire le fichier dans un objet codé en octets au moyen de la cmdlet Get-Content (par exemple, -FileData $([byte[]](Get-Content -Encoding byte -Path "C:\My Documents\contoso.xml" -ReadCount 0))).

IntranetLicensingUrl

Obligatoire

System.Uri

Le paramètre IntranetLicensingUrl spécifie l'URL d'attribution de licences internes du serveur AD RMS local qui est inscrite dans la licence de publication. La licence de publication précise les utilisateurs qui peuvent ouvrir du contenu, les conditions sous lesquelles ce contenu peut être ouvert par l'utilisateur et les droits dont bénéficie chaque utilisateur pour ce contenu protégé.

Par défaut, la valeur du paramètre IntranetLicensingUrl est https://<server name>/_wmcs/licensing.

Name

Requis

System.String

Le paramètre Name spécifie le nom du service TPD. Si vous utilisez le paramètre RefreshTemplates, la valeur doit correspondre au nom du domaine de publication approuvé précédemment importé.

Password

Obligatoire

System.Security.SecureString

Le paramètre Password spécifie le mot de passe du domaine de publication approuvé à importer. Vous devez spécifier la valeur de ce paramètre dans un format sécurisé, par exemple (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).

Le mot de passe doit correspondre au mot de passe employé dans le fichier XML au moment d'exporter le domaine de publication approuvé à partir du serveur AD RMS local.

RMSOnline

Obligatoire

System.Management.Automation.SwitchParameter

Le commutateur RMSOnline spécifie que le domaine de publication approuvé est importé à partir de RMS Online. Ce paramètre n'est disponible que dans les organisations Microsoft Exchange Online.

RMSOnlineConfig

Obligatoire

System.Byte[]

Ce paramètre est réservé à l’usage interne chez Microsoft.

RMSOnlineKeys

Obligatoire

System.Collections.Hashtable

Ce paramètre est réservé à l’usage interne chez Microsoft.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Default

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Default spécifie qu'il s'agit du domaine de publication approuvé par défaut. Le TPD par défaut affiche les modèles RMS et offre une protection à l'ensemble du nouveau contenu. Il ne peut y avoir qu'un seul service TPD par défaut dans une organisation.

Le premier domaine de publication approuvé que vous importez dans votre organisation est automatiquement défini par défaut.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est réservé à l’usage interne chez Microsoft.

ExtranetCertificationUrl

Facultatif

System.Uri

Le paramètre ExtranetCertificationUrl spécifie l'URL de certification externe du serveur AD RMS local qui est inscrite dans le certificat de compte de droits. Le certificat de compte des droits établit l'identité d'un utilisateur dans le système AD RMS et sert à déchiffrer du contenu.

Par défaut, la valeur du paramètre ExtranetCertificationUrl est https://<FQDN>/_wmcs/certification/servercertification.asmx.

IntranetCertificationUrl

Facultatif

System.Uri

Le paramètre IntranetCertificationUrl spécifie l'URL de certification interne du serveur AD RMS local qui est inscrite dans le RAC. Le certificat de compte des droits établit l'identité d'un utilisateur dans le système AD RMS et sert à déchiffrer du contenu.

Par défaut, la valeur du paramètre IntranetCertificationUrl est https://<server name>/_wmcs/certification/servercertification.asmx.

RefreshTemplates

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre RefreshTemplates indique si les modèles RMS doivent être mis à jour dans un domaine de publication approuvé préalablement importé. Lorsque vous ajoutez, modifiez ou supprimez des modèles RMS dans un domaine de publication approuvé sur le serveur AD RMS, vous exportez ce domaine mis à jour dans un nouveau fichier XML, puis importez le fichier XML dans votre organisation en nuage. Le paramètre RefreshTemplates utilise les règles suivantes :

  • Seuls les paramètres FileData, Password et Name sont requis. La valeur du paramètre Name doit correspondre au nom du domaine de publication approuvé précédemment importé.

  • Si le nouveau fichier XML ne contient aucun modèle RMS défini dans le domaine de publication approuvé précédemment importé, le modèle RMS est supprimé de l'organisation en nuage.

  • Si le nouveau fichier XML contient un modèle RMS mis à jour et défini dans le domaine de publication approuvé précédemment importé, les paramètres du modèle RMS sont mis à jour dans l'organisation en nuage. En revanche, le modèle RMS n'est pas modifié et redéfini de Archived vers Distributed ou inversement.

  • Si le nouveau fichier XML comporte un modèle RMS qui n'a pas été importé dans le domaine de publication approuvé d'origine, le modèle RMS est ajouté à l'organisation en nuage avec l'état Archived. Pour rendre le nouveau modèle RMS exploitable, vous devez redéfinir son état de Archived vers Distributed à l'aide de la cmdlet Set-RMSTemplate.

RMSOnlineAuthCertSubjectNameOverride

Facultatif

System.String

Ce paramètre est réservé à l’usage interne chez Microsoft.

RMSOnlineAuthorTest

Facultatif

System.Collections.Hashtable

Ce paramètre est réservé à l’usage interne chez Microsoft.

RMSOnlineOrgOverride

Facultatif

System.Guid

Ce paramètre est réservé à l’usage interne chez Microsoft.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: