Set-ExchangeSettings

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

Use o cmdlet Set-ExchangeSettings para configurar 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.

Syntax

Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ClearHistory]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -ConfigValue <String>
   -Reason <String>
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -Reason <String>
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]
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>]
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>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-CreateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
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>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ExpirationDate <DateTime>]
   [-GroupName <String>]
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Priority <Int32>]
   [-ScopeFilter <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-GroupName <String>]
   [-RemoveSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
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 tópico 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 Registro Em Log de Auditoria Unificada. Este exemplo pressupõe que você já tenha criado 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

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

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

-ConfigName

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

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

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

-ConfigPairs

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

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

-ConfigValue

O parâmetro ConfigValue especifica o valor para a configuração do Exchange especificada com o parâmetro ConfigName. Os valores são determinados pelo tipo de configuração (um número, um tempo limite, $true ou $false etc.).

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

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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-CreateSettingsGroup

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

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

-Disable

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 essa sintaxe -Disable:$falseexata .

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

-DisableGroup

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.

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

-DomainController

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.

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

-EnableGroup

O parâmetro EnableGroup especifica o nome do grupo de configurações do Exchange desabilitado 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.

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

-ExpirationDate

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/yyyy, 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.

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

-Force

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.

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

-GenericScopeName

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.

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

-GenericScopeValue

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.

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

-GroupName

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 grupos de configurações do Exchange existentes.
  • 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 (").

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

-GuidMatch

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 do Escopo que não sejam Forest.

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

Você não pode usar esse parâmetro com os parâmetros GenericScopeName, GenericScopeValue, MaxVersion, MinVersion ou NameMatch.

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

-Identity

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

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

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

-MaxVersion

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 do Escopo que não sejam Forest.

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

Você não pode usar esse parâmetro com os parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

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

-MinVersion

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 do Escopo que não sejam Forest.

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

Você não pode usar esse parâmetro com parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

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

-NameMatch

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 do Escopo que não sejam Forest.

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

Você não pode usar esse parâmetro com os parâmetros GuidMatch, GenericScopeName ou GenericScopeValue.

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

-Priority

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 menor indica uma prioridade maior.

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

-Reason

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

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

-RemoveSetting

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

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

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

-RemoveSettingsGroup

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.

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

-Scope

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

  • Dag
  • Banco de dados
  • Floresta
  • Generic
  • Organização
  • Processo
  • Servidor
  • User
Type:ExchangeSettingsScope
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-ScopeFilter

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

  • Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrada.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais 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. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and 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.

Você não pode usar esse parâmetro com o parâmetro Scope e o valor Floresta ou outros parâmetros relacionados ao escopo.

Use esse parâmetro somente quando atualizar grupos de configurações do Exchange usando a opção UpdateSettingsGroup com o parâmetro GroupName.

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

-SettingsGroup

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

Você não pode usar o parâmetro SettingsGroup com o parâmetro GroupName.

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

-UpdateSetting

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

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

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

-UpdateSettingsGroup

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

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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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