Set-SettingOverride
La cmdlet est disponible uniquement dans Exchange en local.
Attention : une utilisation incorrecte des applets de commande de remplacement de paramètre peut causer des dommages graves à votre organization Exchange. Ces dommages peuvent nécessiter la réinstallation d’Exchange. Utilisez uniquement ces applets de commande comme indiqué dans la documentation du produit ou sous la direction du service clientèle et du support 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
Les remplacements de paramètres configurent et stockent les personnalisations du serveur Exchange dans Active Directory. Les paramètres peuvent être organization à l’échelle de l’ensemble ou spécifiques au serveur, et ils sont conservés dans Active Directory dans les Mises à jour cumulatives (UC) Exchange. Les personnalisations Exchange dans web.config ou exe.config fichiers de configuration d’application XML 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 montre comment modifier le remplacement du paramètre 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 sur 3 heures.
Paramètres
-Confirm
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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-*) 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 cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
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
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
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
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
Le paramètre MaxVersion spécifie la dernière version d’Exchange 2016 à laquelle ce remplacement s’applique (jusqu’à et y compris la valeur spécifiée).
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
Le paramètre MinVersion spécifie la version la plus ancienne d’Exchange 2016 à laquelle ce remplacement s’applique (jusqu’à et y compris la valeur spécifiée).
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
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
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
Le paramètre Server spécifie le nom du serveur Exchange 2016 sur lequel vous souhaitez appliquer le remplacement. 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 le remplacement à tous.
Pour supprimer le serveur spécifié afin que le remplacement s’applique à tous les serveurs Exchange 2016 dans la 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
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.
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.