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 |
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 |
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 |
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