Set-ExchangeSettings

Le commutateur ClearHistory spécifie que vous souhaitez effacer les entrées de l’historique des modifications de l’objet de paramètre Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le paramètre ConfigName spécifie le paramètre Exchange disponible que vous souhaitez ajouter, supprimer ou mettre à jour dans l’objet paramètres Exchange. Les valeurs valides pour ce paramètre sont déterminées par le schéma de configuration qui a été spécifié par le paramètre Name dans la cmdlet New-ExchangeSettings.

Pour les opérations d’ajout et de mise à jour, vous devez également utiliser le paramètre ConfigValue afin de spécifier la valeur réelle du paramètre. Vous ne pouvez pas utiliser le paramètre ConfigName avec le paramètre ConfigPairs.

Le paramètre ConfigName spécifie le paramètre Exchange disponible que vous souhaitez ajouter, supprimer ou mettre à jour dans l’objet paramètres Exchange. Les valeurs valides pour ce paramètre sont déterminées par le schéma de configuration qui a été spécifié par le paramètre Name dans la cmdlet New-ExchangeSettings. La syntaxe d’une valeur est <Key>=<Value>. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Vous ne pouvez pas utiliser le paramètre ConfigPairs avec les paramètres ConfigName ou ConfigValue.

Le paramètre ConfigValue spécifie la valeur du paramètre Exchange que vous avez spécifié avec le paramètre ConfigName. Les valeurs sont déterminées par le type de paramètre (un nombre, un intervalle de temps, $true ou $false, etc.).

Vous ne pouvez pas utiliser le paramètre ConfigValue avec le paramètre ConfigPairs.

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.

Le commutateur CreateSettingsGroup spécifie que vous créez un groupe de paramètres Exchange, qui est un groupe de paramètres Exchange associés. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Selon la façon dont vous souhaitez configurer le groupe de paramètres, vous utilisez le paramètre GroupName ou le paramètre SettingsGroup pour spécifier le nom du groupe de paramètres Exchange. Faites le bon choix, car vous ne pouvez pas renommer un groupe de paramètres existant.

Le commutateur Désactiver spécifie que le groupe de paramètres Exchange est désactivé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur uniquement avec le commutateur CreateSettingsGroup.

Pour utiliser ce commutateur afin d’activer un groupe de paramètres Exchange, utilisez cette syntaxe -Disable:$falseexacte.

Le paramètre DisableGroup spécifie le nom du groupe de paramètres Exchange activé que vous souhaitez désactiver. Si la valeur contient des espaces, placez-la entre guillemets (").

Vous pouvez utiliser les paramètres DisableGroup et EnableGroup ensemble dans la même commande pour activer et désactiver différents groupes de paramètres Exchange en même temps.

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 ».

Le paramètre EnableGroup spécifie le nom du groupe de paramètres Exchange désactivé que vous souhaitez activer. Si la valeur contient des espaces, placez-la entre guillemets (").

Vous pouvez utiliser les paramètres DisableGroup et EnableGroup ensemble dans la même commande pour activer et désactiver différents groupes de paramètres Exchange en même temps.

Le paramètre ExpirationDate spécifie la date/heure de fin des paramètres Exchange définis par le groupe de paramètres Exchange spécifié.

Utilisez le format de date courte défini dans les paramètres Options régionales sur l’ordinateur où la commande est exécutée. Par exemple, si l’ordinateur est configuré pour utiliser le format de date courte jj/mm/aaaa, entrez 01/09/2018 pour spécifier le 1er septembre 2018. Vous pouvez entrer uniquement la date ou vous pouvez entrer la date et l'heure du jour. Si vous entrez la date et l’heure de la journée, placez la valeur entre guillemets ("), par exemple, "01/09/2018 17:00".

Vous ne pouvez utiliser le paramètre ExpirationDate qu’avec les paramètres de groupe CreateSettingsGroup ou UpdateSettings.

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.

Le paramètre GenericScopeName spécifie le nom de l’étendue. Les valeurs disponibles sont déterminées par le schéma de l’objet de paramètre Exchange.

Le paramètre GenericScopeValue spécifie la valeur de l’étendue spécifiée par le paramètre GenericScopeName. Les valeurs disponibles sont déterminées par le schéma de l’objet de paramètre Exchange.

Le paramètre GroupName spécifie le nom du groupe de paramètres Exchange dans les opérations de groupe. Par exemple :

• Créez des groupes de paramètres Exchange et configurez simultanément l’étendue et la priorité du groupe.
• Modifiez les valeurs ExpirationDate, Priority et ScopeFilter des groupes de paramètres Exchange existants.
• Supprimez les groupes de paramètres Exchange existants.
• Ajoutez, supprimez ou mettez à jour des objets de paramètres Exchange dans des groupes de paramètres Exchange existants.

Si la valeur contient des espaces, placez-la entre guillemets (").

Le paramètre GuidMatch spécifie l’étendue d’un groupe de paramètres Exchange en fonction du GUID de l’objet (par exemple, le GUID de la base de données de boîtes aux lettres). Ce paramètre est disponible pour toutes les valeurs de paramètre Scope autres que Forest.

Vous utilisez le paramètre GuidMatch uniquement lorsque vous créez des groupes de paramètres Exchange à l’aide du commutateur CreateSettingsGroup avec le paramètre GroupName.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres GenericScopeName, GenericScopeValue, MaxVersion, MinVersion ou NameMatch.

Le paramètre Identity spécifie le nom de l’objet de paramètres Exchange existant qui contient les paramètres Exchange que vous souhaitez configurer.

La valeur de ce paramètre est la valeur du paramètre Name sur l’applet de commande New-ExchangeSetting lors de la création de l’objet de paramètres Exchange.

Le paramètre MaxVersion spécifie l’étendue d’un groupe de paramètres Exchange en fonction de la version de l’objet (par exemple, la version d’Exchange installée sur le serveur). Ce paramètre est disponible pour toutes les valeurs de paramètre Scope autres que Forest.

Vous utilisez le paramètre MaxVersion avec le paramètre MinVersion uniquement lorsque vous créez des groupes de paramètres Exchange à l’aide du commutateur CreateSettingsGroup avec le paramètre GroupName.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres GuidMatch, GenericScopeName ou GenericScopeValue.

Le paramètre MinVersion spécifie l’étendue d’un groupe de paramètres Exchange en fonction de la version de l’objet (par exemple, la version d’Exchange installée sur le serveur). Ce paramètre est disponible pour toutes les valeurs de paramètre Scope autres que Forest.

Vous utilisez le paramètre MinVersion avec le paramètre MaxVersion uniquement lorsque vous créez des groupes de paramètres Exchange à l’aide du commutateur CreateSettingsGroup avec le paramètre GroupName.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres GuidMatch, GenericScopeName ou GenericScopeValue.

Le paramètre NameMatch spécifie l’étendue d’un groupe de paramètres Exchange en fonction du nom de l’objet (par exemple, le nom du processus). Ce paramètre est disponible pour toutes les valeurs de paramètre Scope autres que Forest.

Vous utilisez le paramètre NameMatch uniquement lorsque vous créez des groupes de paramètres Exchange à l’aide du commutateur CreateSettingsGroup avec le paramètre GroupName.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres GuidMatch, GenericScopeName ou GenericScopeValue.

Le paramètre Priority spécifie la priorité d’un groupe de paramètres Exchange. La valeur de priorité doit être unique pour chaque groupe. Une faible valeur de priorité indique une priorité élevée.

Le paramètre Reason spécifie une description de la raison pour laquelle le paramètre Exchange ou le groupe de paramètres a été créé ou modifié. Si la valeur contient des espaces, placez-la entre guillemets (").

Le commutateur RemoveSetting spécifie que vous supprimez un paramètre Exchange existant d’un objet de paramètres Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous utilisez le paramètre ConfigPairs ou ConfigName pour spécifier le paramètre à supprimer.

Le commutateur RemoveSettingsGroup spécifie que vous supprimez un groupe de paramètres Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous utilisez le paramètre GroupName pour spécifier le groupe de paramètres Exchange à supprimer.

Le paramètre Scope spécifie l’étendue de l’objet de paramètres Exchange. Les valeurs valides sont les suivantes :

• Dag
• Database
• Forest (Forêt)
• Generic
• Organisation
• Processus
• Serveur
• Utilisateur

Le paramètre ScopeFilter utilise la syntaxe de filtre OPATH pour spécifier l’étendue d’un groupe de paramètres Exchange basé. La syntaxe est "Property -ComparisonOperator 'Value'" (par exemple, "ServerRole -like 'Mailbox*'").

• Placez l’ensemble du filtre OPATH entre guillemets doubles « ». Si le filtre contient des valeurs système (par exemple, $true, $falseou $null), utilisez plutôt des guillemets simples « ». Bien que ce paramètre soit une chaîne (et non un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
• Property est une propriété filtrable.
• ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq pour des valeurs égales et -like pour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
• Value est la valeur de propriété à rechercher. Placez les valeurs de texte et les variables entre guillemets simples ('Value' ou '$Variable'). Si une valeur de variable contient des guillemets simples, vous devez identifier (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez 500, $true, $falseou $null à la place).

Vous pouvez chaîner plusieurs critères de recherche à l’aide des opérateurs logiques -and et -or. Par exemple : "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.

Vous ne pouvez pas utiliser ce paramètre avec le paramètre Scope et la valeur Forest ou d’autres paramètres liés à l’étendue.

Vous utilisez ce paramètre uniquement lorsque vous mettez à jour des groupes de paramètres Exchange à l’aide du commutateur UpdateSettingsGroup avec le paramètre GroupName.

Le paramètre SettingsGroup spécifie un groupe de paramètres Exchange existant utilisé pour créer un groupe de paramètres ou modifier un groupe de paramètres existant.

Vous ne pouvez pas utiliser le paramètre SettingsGroup avec le paramètre GroupName.

Le commutateur UpdateSetting spécifie que vous mettez à jour un paramètre Exchange dans un objet de paramètres Exchange existant. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous utilisez le paramètre ConfigPairs ou les paramètres ConfigName et ConfigValue pour configurer le paramètre Exchange.

Le commutateur UpdateSettingsGroup spécifie que vous modifiez un groupe de paramètres Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Selon la façon dont vous souhaitez configurer le groupe de paramètres, vous utilisez le paramètre GroupName ou le paramètre SettingsGroup pour spécifier le groupe de paramètres Exchange que vous souhaitez modifier.

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.