Set-SettingOverride

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

Cuidado: o uso incorreto dos cmdlets de substituição de configuração pode causar sérios danos à sua organização do Exchange. Esse dano pode exigir que você reinstale o Exchange. Use apenas esses cmdlets conforme instruído pela documentação do produto ou sob a direção de Microsoft Serviço e Suporte ao Cliente.

Use o cmdlet Set-SettingOverride para modificar substituições de configuração que armazenam personalizações do Exchange no Active Directory em vez de em arquivos de texto no servidor.

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

Syntax

Set-SettingOverride
   [-Identity] <SettingOverrideIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-Parameters <MultiValuedProperty>]
   [-Reason <String>]
   [-Server <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

As substituições de configuração configuram e armazenam personalizações de servidor do Exchange no Active Directory. As configurações podem ser específicas da organização ou do servidor e persistem no Active Directory em CUs (Atualizações Cumulativas do Exchange). As personalizações do Exchange em web.config ou exe.config arquivos de configuração de aplicativo XML são específicas do servidor e são perdidas quando você instala a próxima CU do Exchange.

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-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")

Este exemplo modifica a substituição de configuração chamada Geração OAB de Alteração no servidor chamado Mailbox01 alterando o intervalo de geração do OAB para 3 horas.

Parâmetros

-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 2013, 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 2013, 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

-Identity

O parâmetro Identity especifica a substituição de configuração que você deseja modificar. Você pode usar um valor que identifica exclusivamente a substituição. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:SettingOverrideIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxVersion

O parâmetro MaxVersion especifica a versão mais recente do Exchange 2016 à qual essa substituição se aplica (até e incluindo o valor especificado).

A entrada válida para esse parâmetro é um valor de versão do Exchange 2016 no formato 15.1.xxx.xx. Você pode usar valores com zeros à esquerda, mas os zeros à esquerda são removidos dos resultados. Por exemplo, 15.01.0225.042 é armazenada como 15.1.225.42.

Para remover um valor de versão configurado para que a substituição se aplique a todas as versões do Exchange 2016, use o valor $null.

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

-MinVersion

O parâmetro MinVersion especifica a versão mais antiga do Exchange 2016 à qual essa substituição se aplica (até e incluindo o valor especificado).

A entrada válida para esse parâmetro é um valor de versão do Exchange 2016 no formato 15.1.xxx.xx. Você pode usar valores com zeros à esquerda, mas os zeros à esquerda são removidos dos resultados. Por exemplo, 15.01.0225.042 é armazenada como 15.1.225.42.

Para remover um valor de versão configurado para que a substituição se aplique a todas as versões do Exchange 2016, use o valor $null.

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

-Parameters

O parâmetro Parameters especifica um ou mais parâmetros para a substituição que estão disponíveis para a combinação dos valores do parâmetro Component e Section. Esse parâmetro usa a sintaxe: @("Parameter1=Value1","Parameter2=Value2"...). Por exemplo:

  • @("Enabled=true")
  • @("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Reason

O parâmetro Reason é usado para fornecer uma descrição do motivo pelo qual a substituição foi criada. 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 2013, Exchange Server 2016, Exchange Server 2019

-Server

O parâmetro Server especifica o nome do servidor exchange 2016 em que você deseja que a substituição seja aplicada. Você pode especificar um único nome de servidor do Exchange 2016 ou uma matriz de curingas de nome de servidor do Exchange 2016. Por exemplo, se você tiver três servidores do Exchange 2016 chamados Exchange01, Exchange02 e Exchange03, especifique o valor Exchange* para aplicar a substituição a todos eles.

Para remover o servidor especificado para que a substituição se aplique a todos os servidores do Exchange 2016 na floresta do Active Directory, use o valor $null.

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

-WhatIf

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