New-RemoteDomain

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-07-18

La cmdlet New-RemoteDomain permet de créer une connexion gérée pour un domaine distant. Lorsque vous créez un domaine distant, vous pouvez contrôler le flux de messagerie plus précisément, appliquer une mise en forme de messages et des stratégies de messagerie, ainsi que spécifier des jeux de caractères acceptables pour les messages échangés avec le domaine distant.

Pour plus d'informations sur la configuration du domaine distant, consultez la rubrique Set-RemoteDomain.

Syntaxe

New-RemoteDomain -Name <String> -DomainName <SmtpDomainWithSubdomains> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet New-RemoteDomain, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ces informations de configuration à partir du service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance Active Directory Application Mode (ADAM).

DomainName

Obligatoire

Microsoft.Exchange.Data.SmtpDomainWithSubdomains

Une entrée valide pour le paramètre DomainName est un domaine SMTP (Simple Mail Transfer Protocol). Entrez le domaine SMTP que vous voulez établir comme domaine distant. Vous pouvez utiliser un caractère générique pour spécifier tous les sous-domaines d'un domaine donné, comme le montre l'exemple suivant : *.contoso.com. En revanche, vous ne pouvez pas imbriquer un caractère générique, comme le montre l'exemple suivant : domain.*.contoso.com. La chaîne du nom de domaine ne peut pas contenir plus de 256 caractères.

Name

Obligatoire

System.String

Le paramètre Name permet de créer un nom unique pour l'objet domaine distant.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour le paramètre TemplateInstance, la commande utilise la configuration de l'objet pour créer une copie de celui-ci sur un serveur local ou cible.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Exemple

Les exemples suivants montrent comment la cmdlet New-RemoteDomain permet de créer une connexion gérée pour un domaine distant.

Le premier exemple montre comment créer un domaine distant nommé Contoso.

Le second exemple montre comment créer un domaine distant nommé Adatum. Dans la cmdlet Set-RemoteDomain, le paramètre AllowedOOFType est défini sur None, et le paramètre DisplaySenderName est défini sur $False sur Adatum. Adatum est alors attribué à la variable nommée $Example. La variable $Example est transmise au paramètre TemplateInstance lorsqu'un nouveau domaine distant nommé Contoso est créé. Ceci crée une copie exacte de l'objet domaine distant Adatum sur Contoso. Parce que le paramètre TemplateInstance crée une copie exacte de l'objet domaine distant, les valeurs sur le paramètre AllowedOOFType et le paramètre DisplaySenderName sur Contoso correspondent aux valeurs sur Adatum.

Pour plus d'informations sur la définition d'options de configuration supplémentaires sur un objet domaine distant, consultez la rubrique Set-RemoteDomain. Pour plus d'informations sur l'affichage des informations de configuration pour les objets domaine distant dans votre organisation, consultez la rubrique Get-RemoteDomain.

New-RemoteDomain -DomainName Contoso.com -Name Contoso 

New-RemoteDomain -DomainName Adatum.com -Name Adatum
Set-RemoteDomain Adatum -AllowedOOFType None -DisplaySenderName $False
$Example = Get-RemoteDomain Adatum
New-RemoteDomain -DomainName Contoso.com -Name Contoso -TemplateInstance $Example