Set-SettingOverride
La cmdlet est disponible uniquement dans Exchange en local.
Attention : une utilisation incorrecte des cmdlets de remplacement des paramètres peut causer de graves dommages à votre organisation Exchange. Vous pourriez alors devoir réinstaller Exchange. Utilisez uniquement ces applets de commande conformément aux instructions de la documentation du produit ou sous la direction du support technique et du service clientèle Microsoft.
Utilisez l’applet de commande Set-SettingOverride pour modifier les remplacements de paramètres qui stockent les personnalisations Exchange dans Active Directory plutôt que dans des fichiers texte sur le serveur.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
Set-SettingOverride
[-Identity] <SettingOverrideIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-Parameters <MultiValuedProperty>]
[-Reason <String>]
[-Server <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Le paramètre remplace, configure et stocke les personnalisations du serveur Exchange dans Active Directory. Les paramètres peuvent être spécifiques à l’ensemble de l’organisation ou au serveur, et ils sont conservés dans Active Directory dans les mises à jour cumulatives (CU) Exchange. Les personnalisations Exchange dans les fichiers de configuration d’application XML web.config ou exe.config sont spécifiques au serveur et sont perdues lorsque vous installez la prochaine mise à jour cumulative Exchange.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")
Cet exemple modifie le paramètre de remplacement nommé Modifier la génération du carnet d’adresses en mode hors connexion sur le serveur nommé Mailbox01 en définissant l’intervalle de génération du carnet d’adresses en mode hors connexion à 3 heures.
Paramètres
-Confirm
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Cette applet de commande a une pause intégrée, utilisez-la -Confirm:$false pour ignorer la confirmation.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 ».
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Identity spécifie le remplacement de paramètre à modifier. Vous pouvez utiliser une valeur qui identifie le remplacement de manière unique. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Propriétés du paramètre
| Type: | SettingOverrideIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-MaxVersion
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre MaxVersion spécifie la dernière version d’Exchange 2016 à laquelle ce remplacement s’applique (jusqu’à la valeur spécifiée incluse).
L’entrée valide pour ce paramètre est une valeur de version Exchange 2016 au format 15.1.xxx.xx. Vous pouvez utiliser des valeurs avec des zéros non significatifs, mais ceux-ci sont supprimés des résultats. Par exemple, 15.01.0225.042 est stocké sous la forme 15.1.225.42.
Pour supprimer une valeur de version configurée afin que le remplacement s’applique à toutes les versions d’Exchange 2016, utilisez la valeur $null.
Propriétés du paramètre
| Type: | Version |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MinVersion
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre MinVersion spécifie la version la plus ancienne d’Exchange 2016 à laquelle ce remplacement s’applique (jusqu’à la valeur spécifiée incluse).
L’entrée valide pour ce paramètre est une valeur de version Exchange 2016 au format 15.1.xxx.xx. Vous pouvez utiliser des valeurs avec des zéros non significatifs, mais ceux-ci sont supprimés des résultats. Par exemple, 15.01.0225.042 est stocké sous la forme 15.1.225.42.
Pour supprimer une valeur de version configurée afin que le remplacement s’applique à toutes les versions d’Exchange 2016, utilisez la valeur $null.
Propriétés du paramètre
| Type: | Version |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Parameters
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Parameters spécifie un ou plusieurs paramètres pour le remplacement, lesquels sont disponibles pour la combinaison des valeurs de paramètre Component et Section. Ce paramètre utilise la syntaxe : @("Parameter1=Value1","Parameter2=Value2"...). Par exemple :
@("Enabled=true")@("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Reason
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Reason sert à décrire la raison de la création du remplacement. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Server
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Serveur spécifie le nom du serveur Exchange 2016 auquel vous souhaitez appliquer la surcharge. Vous pouvez spécifier un nom de serveur Exchange 2016 unique ou un tableau de caractères génériques de nom de serveur Exchange 2016. Par exemple, si vous avez trois serveurs Exchange 2016 nommés Exchange01, Exchange02 et Exchange03, spécifiez la valeur Exchange* pour appliquer la surcharge à chacun d’eux.
Pour supprimer le serveur spécifié afin que le remplacement s’applique à tous les serveurs Exchange 2016 du forêt Active Directory, utilisez la valeur $null.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.