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 organisation 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 de Microsoft service clientèle et support technique.

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.

Syntax

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 propres à l’ensemble de l’organisation ou au serveur, et ils sont conservés dans Active Directory sur les Mises à jour cumulatives 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 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-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")

Cet exemple modifie 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

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 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 2013, Exchange Server 2016, Exchange Server 2019

-Force

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Identity

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
Type:SettingOverrideIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxVersion

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.

Type:Version
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

-MinVersion

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.

Type:Version
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

-Parameters

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>")
Type:MultiValuedProperty
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

-Reason

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 (").

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 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 la substitution à 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.

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

-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 2013, Exchange Server 2016, Exchange Server 2019