Set-OutlookProvider
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-OutlookProvider permet de définir des paramètres globaux spécifiques à l’aide de l’attribut msExchOutlookProvider sur l'objet msExchAutoDiscoverConfig dans le service d’annuaire Active Directory.
Syntaxe
Set-OutlookProvider -Identity <OutlookProviderIdParameter> [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]
Set-OutlookProvider [-CertPrincipalName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <OutlookProvider>] [-Name <String>] [-Server <String>] [-TTL <Int32>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Set-OutlookProvider crée les paramètres globaux pour le service de découverte automatique. Elle définit l’objet AutoDiscoverConfig sous l’objet Global Settings dans Active Directory et les attributs spécifiés dans les paramètres indiqués dans la section Paramètres.
Pour exécuter la cmdlet Set-OutlookProvider, 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 |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.OutlookProviderIdParameter |
Le paramètre Identity spécifie la valeur ADIDParameter du protocole MAPI pour lequel vous voulez définir des paramètres globaux. |
CertPrincipalName |
Facultatif |
System.String |
Le paramètre CertPrincipalName spécifie le nom principal du certificat SSL (Secure Sockets Layer) requis pour la connexion à Exchange à partir d’un emplacement externe. Ce paramètre est utilisé uniquement pour les clients Microsoft Outlook Anywhere. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.OutlookProvider |
Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. |
Name |
Facultatif |
System.String |
Le paramètre Name permet de spécifier un nom commun pour l'objet configuration de fournisseur Outlook. Il peut s'agir d'un nom familier facilitant l'identification. |
Server |
Facultatif |
System.String |
Le paramètre Server permet de spécifier le serveur de messagerie à utiliser pour les clients Outlook Anywhere. |
TTL |
Facultatif |
System.Int32 |
Le paramètre TTL spécifie la durée (en heure) de validité des paramètres spécifiés. Si une valeur est spécifiée, les paramètres sont redécouverts via la découverte automatique après la durée spécifiée avec ce paramètre. Une valeur égale à 0 indique qu'aucune nouvelle découverte n'est requise. La valeur par défaut est 1 heure. |
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, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Dans cet exemple, la commande Set-OutlookProvider permet de modifier la durée de validité des paramètres de découverte automatique pour le fournisseur Outlook msExchAutoDiscoverConfig.
Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2