Partager via


Set-ExchangeSettings

La cmdlet est disponible uniquement dans Exchange en local.

Utilisez l’applet de commande Set-ExchangeSettings pour configurer les objets de paramètre Exchange que vous avez créés avec l’applet de commande New-ExchangeSettings.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

ClearHistory

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ClearHistory]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -ConfigValue <String>
    -Reason <String>
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -Reason <String>
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-MaxVersion <String>]
    [-MinVersion <String>]
    [-NameMatch <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGuid

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -GuidMatch <Guid>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-CreateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGeneric

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-CreateSettingsGroup]
    [-ConfigPairs <String[]>]
    [-GenericScopeName <String>]
    [-GenericScopeValue <String>]
    [-GroupName <String>]
    [-Confirm]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ExpirationDate <DateTime>]
    [-GroupName <String>]
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

RemoveSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-GroupName <String>]
    [-RemoveSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

EnableSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-EnableGroup <String>]
    [-DisableGroup <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Description

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-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

Cet exemple permet aux utilisateurs de voir les résultats de la journalisation d’audit unifié. Cet exemple suppose que vous avez déjà créé un objet de paramètres Exchange pour le schéma de configuration d’audit en exécutant la commande New-ExchangeSettings -Name Audit.

Paramètres

-ClearHistory

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

ClearHistory
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConfigName

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

UpdateSetting
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveSetting
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConfigPairs

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveMultipleSettings
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateMultipleSettings
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConfigValue

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

UpdateSetting
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : 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.

Cette applet de commande a une pause intégrée. Utilisez -Confirm:$false donc 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

-CreateSettingsGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupAdvanced
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Disable

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisableGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

EnableSettingsGroup
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 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

-EnableGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

EnableSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExpirationDate

Applicable : Exchange Server 2016, Exchange Server 2019

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 MM/jj/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 pouvez uniquement utiliser le paramètre ExpirationDate avec les paramètres de groupe CreateSettingsGroup ou UpdateSettings.

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CreateSettingsGroup
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroup
Position:Named
Obligatoire:True
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

-GenericScopeName

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GenericScopeValue

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GroupName

Applicable : Exchange Server 2016, Exchange Server 2019

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

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

UpdateSetting
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveSetting
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveMultipleSettings
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateMultipleSettings
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GuidMatch

Applicable : Exchange Server 2016, Exchange Server 2019

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.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CreateSettingsGroupGuid
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : Exchange Server 2016, Exchange Server 2019

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.

Propriétés du paramètre

Type:ExchangeSettingsIdParameter
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 2016, Exchange Server 2019

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.

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

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

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NameMatch

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Priority

Applicable : Exchange Server 2016, Exchange Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroup
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 2016, Exchange Server 2019

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

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:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveSetting

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

RemoveSetting
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
RemoveMultipleSettings
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveSettingsGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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 que vous souhaitez supprimer.

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

RemoveSettingsGroup
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Scope

Applicable : Exchange Server 2016, Exchange Server 2019

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

Propriétés du paramètre

Type:ExchangeSettingsScope
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGuid
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
CreateSettingsGroupGeneric
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ScopeFilter

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SettingsGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

CreateSettingsGroupAdvanced
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroupAdvanced
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UpdateSetting

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

UpdateSetting
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateMultipleSettings
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UpdateSettingsGroup

Applicable : Exchange Server 2016, Exchange Server 2019

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.

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

UpdateSettingsGroup
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
UpdateSettingsGroupAdvanced
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : 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.