Set-ExchangeSettings

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-ExchangeSettings para definir os objetos de configuração do Exchange que você criou com o cmdlet New-ExchangeSettings.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

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

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

Este exemplo permite que os usuários vejam os resultados do Log de Auditoria Unificada. Este exemplo pressupõe que você já criou um objeto de configurações do Exchange para o esquema de configuração de Auditoria executando o comando New-ExchangeSettings -Name Audit.

Parâmetros

-ClearHistory

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção ClearHistory especifica que você deseja limpar as entradas no histórico de modificações do objeto de configuração do Exchange. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ClearHistory
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConfigName

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ConfigName especifica a configuração disponível do Exchange que você deseja adicionar, remover ou atualizar no objeto de configurações do Exchange. Os valores válidos para esse parâmetro são determinados pelo esquema de configuração que foi especificado pelo parâmetro Name no cmdlet New-ExchangeSettings.

Para operações de adição e atualização, você também precisa usar o parâmetro ConfigValue para especificar o valor real da configuração. Você não pode usar o parâmetro ConfigName com o parâmetro ConfigPairs.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UpdateSetting
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveSetting
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConfigPairs

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ConfigName especifica a configuração disponível do Exchange que você deseja adicionar, remover ou atualizar no objeto de configurações do Exchange. Os valores válidos para esse parâmetro são determinados pelo esquema de configuração que foi especificado pelo parâmetro Name no cmdlet New-ExchangeSettings. A sintaxe para um valor é <Key>=<Value>. Você pode separar vários valores separados por vírgulas.

Você não pode usar o parâmetro ConfigPairs com os parâmetros ConfigName ou ConfigValue.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveMultipleSettings
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateMultipleSettings
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ConfigValue

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ConfigValue especifica o valor da configuração do Exchange que você especificou com o parâmetro ConfigName. Os valores são determinados pelo tipo de configuração (um número, um intervalo de tempo, $true ou $false, etc.).

Você não pode usar o parâmetro ConfigValue com o parâmetro ConfigPairs.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UpdateSetting
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.

Este cmdlet tem uma pausa interna, portanto, use -Confirm:$false para ignorar a confirmação.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CreateSettingsGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção CreateSettingsGroup especifica que você está criando um grupo de configurações do Exchange, que é um grupo de configurações relacionadas do Exchange. Não é preciso especificar um valor com essa opção.

Dependendo de como você deseja definir o grupo de configurações, use o parâmetro GroupName ou o parâmetro SettingsGroup para especificar o nome do grupo de configurações do Exchange. Escolha com cuidado, pois você não pode renomear um grupo de configurações existente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupAdvanced
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Disable

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Desabilitar especifica que o grupo de configurações do Exchange está desabilitado. Não é preciso especificar um valor com essa opção.

Você só pode usar essa opção com a opção CreateSettingsGroup.

Para usar essa opção para habilitar um grupo de configurações do Exchange, use esta sintaxe -Disable:$falseexata.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisableGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DisableGroup especifica o nome do grupo de configurações do Exchange habilitado que você deseja desabilitar. Se o valor contiver espaços, coloque-o entre aspas (").

Você pode usar os parâmetros DisableGroup e EnableGroup juntos no mesmo comando para habilitar e desabilitar diferentes grupos de configurações do Exchange ao mesmo tempo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EnableSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro EnableGroup especifica o nome do grupo de configurações desabilitado do Exchange que você deseja habilitar. Se o valor contiver espaços, coloque-o entre aspas (").

Você pode usar os parâmetros DisableGroup e EnableGroup juntos no mesmo comando para habilitar e desabilitar diferentes grupos de configurações do Exchange ao mesmo tempo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

EnableSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExpirationDate

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ExpirationDate especifica a data/hora de término das configurações do Exchange definidas pelo grupo de configurações do Exchange especificado.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada MM/dd/aaaa, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Você só pode usar o parâmetro ExpirationDate com os parâmetros de grupo CreateSettingsGroup ou UpdateSettings.

Propriedades do parâmetro

Tipo:DateTime
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GenericScopeName

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro GenericScopeName especifica o nome do escopo. Os valores disponíveis são determinados pelo esquema do objeto de configuração do Exchange.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GenericScopeValue

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro GenericScopeValue especifica o valor do escopo especificado pelo parâmetro GenericScopeName. Os valores disponíveis são determinados pelo esquema do objeto de configuração do Exchange.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GroupName

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro GroupName especifica o nome do grupo de configurações do Exchange em operações de grupo. Por exemplo:

  • Crie grupos de configurações do Exchange e configure simultaneamente o escopo e a prioridade do grupo.
  • Modifique os valores ExpirationDate, Priority e ScopeFilter dos grupos de configurações existentes do Exchange.
  • Remova os grupos de configurações existentes do Exchange.
  • Adicione, remova ou atualize objetos de configuração do Exchange em grupos de configurações existentes do Exchange.

Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UpdateSetting
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveSetting
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveMultipleSettings
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateMultipleSettings
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GuidMatch

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro GuidMatch especifica o escopo de um grupo de configurações do Exchange com base no GUID do objeto (por exemplo, o GUID do banco de dados da caixa de correio). Esse parâmetro está disponível para uso com todos os valores de parâmetro Scope que não sejam Forest.

Você usa o parâmetro GuidMatch somente ao criar grupos de configurações do Exchange usando a opção CreateSettingsGroup com o parâmetro GroupName.

Não é possível usar esse parâmetro com os parâmetros GenericScopeName, GenericScopeValue, MaxVersion, MinVersion ou NameMatch.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroupGuid
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Identity especifica o nome do objeto de configurações do Exchange existente que contém as configurações do Exchange que você deseja definir.

O valor desse parâmetro é o valor do parâmetro Nome no cmdlet New-ExchangeSetting quando o objeto de configurações do Exchange foi criado.

Propriedades do parâmetro

Tipo:ExchangeSettingsIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MaxVersion

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro MaxVersion especifica o escopo de um grupo de configurações do Exchange com base na versão do objeto (por exemplo, a versão do Exchange instalada no servidor). Esse parâmetro está disponível para uso com todos os valores de parâmetro Scope que não sejam Forest.

Você usa o parâmetro MaxVersion junto com o parâmetro MinVersion somente ao criar grupos de configurações do Exchange usando a opção CreateSettingsGroup com o parâmetro GroupName.

Não é possível usar esse parâmetro com os parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MinVersion

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro MinVersion especifica o escopo de um grupo de configurações do Exchange com base na versão do objeto (por exemplo, a versão do Exchange instalada no servidor). Esse parâmetro está disponível para uso com todos os valores de parâmetro Scope que não sejam Forest.

Você usa o parâmetro MinVersion junto com o parâmetro MaxVersion somente ao criar grupos de configurações do Exchange usando a opção CreateSettingsGroup com o parâmetro GroupName.

Não é possível usar esse parâmetro com parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NameMatch

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro NameMatch especifica o escopo de um grupo de configurações do Exchange com base no nome do objeto (por exemplo, o nome do processo). Esse parâmetro está disponível para uso com todos os valores de parâmetro Scope que não sejam Forest.

Você usa o parâmetro NameMatch somente ao criar grupos de configurações do Exchange usando a opção CreateSettingsGroup com o parâmetro GroupName.

Não é possível usar esse parâmetro com os parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Priority

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Priority especifica a prioridade de um grupo de configurações do Exchange. O valor de prioridade para cada grupo deve ser exclusivo. Um valor de prioridade mais baixo indica uma prioridade mais alta.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Reason

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Reason especifica uma descrição do motivo pelo qual a configuração ou o grupo de configurações do Exchange foram criados ou modificados. Se o valor contiver espaços, coloque-o entre aspas (").

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSetting

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção RemoveSetting especifica que você está removendo uma configuração existente do Exchange de um objeto de configurações do Exchange. Não é preciso especificar um valor com essa opção.

Use o parâmetro ConfigPairs ou o parâmetro ConfigName para especificar a configuração que deseja remover.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveSetting
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
RemoveMultipleSettings
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveSettingsGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção RemoveSettingsGroup especifica que você está removendo um grupo de configurações do Exchange. Não é preciso especificar um valor com essa opção.

Você usa o parâmetro GroupName para especificar o grupo de configurações do Exchange que deseja remover.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

RemoveSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Scope

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro Scope especifica o escopo do objeto de configurações do Exchange. Os valores válidos são:

  • Presente
  • Banco de dados
  • Floresta
  • Generic
  • Organização
  • Processo
  • Servidor
  • Usuário

Propriedades do parâmetro

Tipo:ExchangeSettingsScope
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGuid
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
CreateSettingsGroupGeneric
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ScopeFilter

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ScopeFilter usa a sintaxe de filtro OPATH para especificar o escopo de um grupo de configurações do Exchange com base. A sintaxe é "Property -ComparisonOperator 'Value'" (por exemplo, "ServerRole -like 'Mailbox*'").

  • Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $false, ou $null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrável.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo, -eq para igual e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
  • Valor é o valor da propriedade a ser pesquisado. Coloque os valores de texto e variáveis entre aspas simples ('Value' ou '$Variable'). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $false, ou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores -and lógicos e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.

Não é possível usar esse parâmetro com o parâmetro Scope e o valor Forest ou outros parâmetros relacionados ao escopo.

Você usa esse parâmetro somente ao atualizar grupos de configurações do Exchange usando a opção UpdateSettingsGroup com o parâmetro GroupName.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroup
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SettingsGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro SettingsGroup especifica um grupo de configurações existente do Exchange que é usado para criar um novo grupo de configurações ou modificar um grupo de configurações existente.

Não é possível usar o parâmetro SettingsGroup com o parâmetro GroupName.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CreateSettingsGroupAdvanced
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroupAdvanced
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UpdateSetting

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção UpdateSetting especifica que você está atualizando uma configuração do Exchange em um objeto de configurações existente do Exchange. Não é preciso especificar um valor com essa opção.

Você usa o parâmetro ConfigPairs ou os parâmetros ConfigName e ConfigValue para definir a configuração do Exchange.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UpdateSetting
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateMultipleSettings
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UpdateSettingsGroup

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção UpdateSettingsGroup especifica que você está modificando um grupo de configurações do Exchange. Não é preciso especificar um valor com essa opção.

Dependendo de como você deseja definir o grupo de configurações, use o parâmetro GroupName ou o parâmetro SettingsGroup para especificar o grupo de configurações do Exchange que você deseja modificar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UpdateSettingsGroup
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
UpdateSettingsGroupAdvanced
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.