New-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 New-SettingOverride pour créer des 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
New-SettingOverride
[-Name] <String>
-Component <String>
-Parameters <MultiValuedProperty>
-Reason <String>
-Section <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-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
New-SettingOverride -Name "IM Override" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"Cet exemple crée un remplacement de paramètre nommé Im Server Integration. Ce remplacement spécifie le pool Skype Entreprise Server 2015 et une empreinte numérique de certificat qui permet l’intégration de la messagerie instantanée entre Outlook sur le web et Skype Entreprise. Étant donné que le paramètre Server n’est pas utilisé, le remplacement s’applique à tous les serveurs Exchange 2016 dans la forêt Active Directory.
Pour plus d’informations, consultez la rubrique Configurer l’intégration de la messagerie instantanée avec Outlook sur le web dans Exchange 2016.
Exemple 2
New-SettingOverride -Name "Change OAB Generation" -Server Mailbox01 -Component TimeBasedAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB Every 2 hours"Cet exemple crée un remplacement de paramètre nommé Modifier la génération du carnet d’adresses en mode hors connexion. Ce remplacement spécifie un intervalle de génération de carnet d’adresses en mode hors connexion de 2 heures. Étant donné que le paramètre Server est utilisé, le remplacement s’applique uniquement au serveur spécifié nommé Mailbox01.
Pour plus d’informations, consultez la rubrique Modifier la planification de génération du carnet d’adresses en mode hors connexion dans Exchange.
Paramètres
-Component
Le paramètre Component spécifie le composant auquel est appliqué le remplacement de paramètre. Par exemple :
- TimeBasedAssistants
- OwaServer
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 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 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.
La valeur par défaut est vide ($null), ce qui signifie que la substitution s’applique à toutes les versions d’Exchange 2016.
| 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.
La valeur par défaut est vide ($null), ce qui signifie que la substitution s’applique à toutes les versions d’Exchange 2016.
| 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 |
-Name
Le paramètre Name spécifie le nom unique du remplacement de paramètre. Si la valeur contient des espaces, placez-la entre guillemets (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reason
Le paramètre Reason spécifie la raison pour laquelle vous créez le remplacement de paramètre. Si la valeur contient des espaces, placez-la entre guillemets (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Section
Le paramètre Section spécifie le nom de la section pour laquelle le remplacement est créé. Les valeurs disponibles pour ce paramètre dépendent de la valeur du paramètre Component.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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.
Si vous n’utilisez pas ce paramètre pour spécifier un serveur, la substitution s’applique à tous les serveurs Exchange 2016 dans la forêt Active Directory.
| 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 |