Partager via


Set-AdSite

 

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

Dernière rubrique modifiée : 2007-06-28

La cmdlet Set-AdSite permet de configurer un site de service d'annuaire Active Directory comme site concentrateur pour remplacer le comportement de routage de messages par défaut d'un ordinateur sur lequel le rôle serveur de transport Hub est installé.

Syntaxe

Set-AdSite -Identity <AdSiteIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HubSiteEnabled <$true | $false>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Set-AdSite [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HubSiteEnabled <$true | $false>] [-Instance <ADSite>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les serveurs de transport Hub Microsoft Exchange 2007 utilisent des sites Active Directory et les coûts affectés aux liens de site Active Directory pour déterminer le chemin de routage le moins coûteux entre deux serveurs de transport Hub de l'organisation. Une fois le chemin de routage le moins coûteux déterminé, les serveurs de transport Hub sources relaient les messages directement vers les serveurs de transport Hub de destination. Par défaut, les serveurs de transport Hub situés dans des sites Active Directory se trouvant sur le chemin reliant le serveur source au serveur de destination ne traitent pas et ne relaient pas les messages.

La cmdlet Set-AdSite permet de remplacer ce comportement en définissant un site Active Directory comme site concentrateur. Lorsqu'un site concentrateur se trouve sur le chemin de routage le moins coûteux entre deux serveurs de transport Hub, les messages sont routés vers le site concentrateur pour traitement avant d'être relayés vers le site de destination.

Pour exécuter la cmdlet Set-AdSite, 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 Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.AdSiteIdParameter

Le paramètre Identity permet de spécifier l'identité du site Active Directory que vous voulez modifier. L'identité peut être exprimée à l'aide d'un GUID ou en utilisant le nom du site Active Directory. Si le nom du site contient des espaces, mettez l'entrée entre guillemets doubles.

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

Le paramètre DomainController permet de spécifier le nom d'hôte ou le nom de domaine complet (FQDN) du contrôleur de domaine qui écrira cette modification dans Active Directory.

HubSiteEnabled

Facultatif

System.Boolean

Le paramètre HubSiteEnabled permet de spécifier si le site agira comme site concentrateur. La valeur par défaut est $false.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADSite

Le paramètre Instance permet de transmettre un objet complet à la commande à traiter. Il est principalement utilisé dans des scripts où un objet complet doit être transmis à la commande.

Name

Facultatif

System.String

Le paramètre Name permet de modifier le nom actuel du site Active Directory. Vous devez disposer des droits Administrateur d'entreprise pour pouvoir utiliser ce paramètre.

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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple de code suivant définit le site Active Directory nommé Default-First-Site-Name comme site concentrateur.

Set-AdSite -Identity Default-First-Site-Name -HubSiteEnabled $true