Set-OutlookProvider
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez l’applet de commande Set-OutlookProvider pour définir des paramètres globaux spécifiques à l’aide de l’attribut msExchOutlookProvider sur l’objet msExchAutoDiscoverConfig dans Active Directory.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Set-OutlookProvider
[-Identity] <OutlookProviderIdParameter>
[-CertPrincipalName <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Name <String>]
[-OutlookProviderFlags <OutlookProviderFlags>]
[-RequiredClientVersions <String[]>]
[-Server <String>]
[-TTL <Int32>]
[-WhatIf]
[<CommonParameters>]
Description
La cmdlet Set-OutlookProvider crée les paramètres globaux pour le service de découverte automatique. Il définit l’objet AutoDiscoverConfig sous l’objet Paramètres globaux dans Active Directory et définit les attributs spécifiés dans les paramètres répertoriés dans la section Paramètres.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2
Cet exemple montre comment modifier la durée pendant laquelle les paramètres du service de découverte automatique sont valides pour le fournisseur Microsoft Outlook msExchAutoDiscoverConfig.
Paramètres
-CertPrincipalName
Le paramètre CertPrincipalName spécifie le nom du 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 Outlook Anywhere.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Le commutateur Confirme 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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false
. - La plupart des autres applets de commande (par exemple, les applets de commande 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Le paramètre Identity spécifie la valeur ADIDParameter du protocole MAPI pour lequel vous voulez définir des paramètres globaux.
Type: | OutlookProviderIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Le paramètre Name spécifie un nom commun pour l’objet Outlook Provider Configuration. Il peut s’agir d’un nom familier facilitant l’identification.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OutlookProviderFlags
Le paramètre OutlookProviderFlags indique le mode de connexion des clients Outlook au serveur Exchange. La valeur peut être définie sur ServerExclusiveConnect, ExternalClientsRequireSSL, InternalClientsRequireSSL ou sur None pour effacer les indicateurs. La valeur recommandée est None, qui est également le paramètre par défaut.
Type: | OutlookProviderFlags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RequiredClientVersions
Le paramètre RequiredClientVersions spécifie la version minimale de Microsoft Outlook autorisée à se connecter au serveur Exchange. Ces informations figurent dans la réponse de découverte automatique à la demande de connexion client. Ce paramètre utilise la syntaxe "MinimumVersion, ExpirationDate"
.
MinimumVersion est la version d’Outlook au format xx.x.xxxx.xxxx. Par exemple, pour spécifier Outlook 2010 Service Pack 2 (SP2), utilisez la valeur 14.0.7012.1000.
ExpirationDate est la date-heure UTC à laquelle les connexions des versions antérieures d’Outlook seront bloquées. La date-heure UTC est représentée au format date-heure ISO 8601 : aaaa-mm-ddThh:mm:ss.fffZ, où aaaa = année, mm = mois, jj = jour, T indique le début du composant heure, hh = heure, mm = minute, ss = seconde, fff = fractions de seconde et Z signifie Zulu, ce qui est une autre façon de désigner UTC.
Un exemple de valeur valide pour ce paramètre est "14.0.7012.1000, 2020-01-01T12:00:00Z"
.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Le paramètre Server spécifie le serveur de boîtes aux lettres à utiliser pour les clients Outlook Anywhere.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TTL
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entrées
Input types
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.
Sorties
Output types
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.