Set-ExchangeSettings

Módulo:

Exchange PowerShell

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

Utilize o cmdlet Set-ExchangeSettings para configurar objetos de definição do Exchange que 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 utilizadores vejam os resultados do Registo de Auditoria Unificado. Este exemplo pressupõe que já criou um objeto de definições do Exchange para o esquema de configuração auditoria ao executar o comando New-ExchangeSettings -Name Audit.

Parâmetros

-ClearHistory

Aplicável: Exchange Server 2016, Exchange Server 2019

O comutador ClearHistory especifica que pretende limpar as entradas no histórico de modificações do objeto de definiçã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

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

Para operações de adição e atualização, também tem de utilizar o parâmetro ConfigValue para especificar o valor real da definição. Não pode utilizar 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

O parâmetro ConfigName especifica a definição do Exchange disponível que pretende adicionar, remover ou atualizar no objeto de definições do Exchange. Os valores válidos para este 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>. Pode separar múltiplos valores separados por vírgulas.

Não pode utilizar 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

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

Não pode utilizar 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

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, 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 confirmar o comando antes de continuar.

Este cmdlet tem uma pausa incorporada, pelo que deve utilizar -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

O comutador CreateSettingsGroup especifica que está a criar um grupo de definições do Exchange, que é um grupo de definições relacionadas do Exchange. Não é preciso especificar um valor com essa opção.

Consoante a forma como pretende configurar o grupo de definições, utilize o parâmetro GroupName ou o parâmetro SettingsGroup para especificar o nome do grupo de definições do Exchange. Escolha cuidadosamente, porque não pode mudar o nome de um grupo de definiçõ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

O comutador Desativar especifica que o grupo de definições do Exchange está desativado. Não é preciso especificar um valor com essa opção.

Só pode utilizar este comutador com o comutador CreateSettingsGroup.

Para utilizar este comutador para ativar um grupo de definições do Exchange, utilize 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

O parâmetro DisableGroup especifica o nome do grupo de definições do Exchange ativado que pretende desativar. Se o valor contiver espaços, coloque-o entre aspas (").

Pode utilizar os parâmetros DisableGroup e EnableGroup em conjunto no mesmo comando para ativar e desativar diferentes grupos de definiçõ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

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

O parâmetro EnableGroup especifica o nome do grupo de definições do Exchange desativado que pretende ativar. Se o valor contiver espaços, coloque-o entre aspas (").

Pode utilizar os parâmetros DisableGroup e EnableGroup em conjunto no mesmo comando para ativar e desativar diferentes grupos de definiçõ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

O parâmetro ExpirationDate especifica a data/hora de fim das definições do Exchange que são definidas pelo grupo de definiçõ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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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".

Só pode utilizar o parâmetro ExpirationDate com os parâmetros do 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

O comutador 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

O parâmetro GenericScopeName especifica o nome do âmbito. Os valores disponíveis são determinados pelo esquema do objeto de definiçã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

O parâmetro GenericScopeValue especifica o valor do âmbito especificado pelo parâmetro GenericScopeName. Os valores disponíveis são determinados pelo esquema do objeto de definiçã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

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

• Crie grupos de definições do Exchange e configure simultaneamente o âmbito e a prioridade do grupo.
• Modifique os valores ExpirationDate, Priority e ScopeFilter dos grupos de definições do Exchange existentes.
• Remover grupos de definições do Exchange existentes.
• Adicionar, remover ou atualizar objetos de definição do Exchange em grupos de definições do Exchange existentes.

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

O parâmetro GuidMatch especifica o âmbito de um grupo de definições do Exchange com base no GUID do objeto (por exemplo, o GUID da base de dados da caixa de correio). Este parâmetro está disponível para utilização com todos os valores de parâmetros de Âmbito diferentes de Forest.

Utiliza o parâmetro GuidMatch apenas quando cria grupos de definições do Exchange com o comutador CreateSettingsGroup com o parâmetro GroupName.

Não pode utilizar este 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

O parâmetro Identidade especifica o nome do objeto de definições do Exchange existente que contém as definições do Exchange que pretende configurar.

O valor deste parâmetro é o valor do parâmetro Name no cmdlet New-ExchangeSetting quando o objeto de definiçõ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

O parâmetro MaxVersion especifica o âmbito de um grupo de definições do Exchange com base na versão do objeto (por exemplo, a versão do Exchange que está instalada no servidor). Este parâmetro está disponível para utilização com todos os valores de parâmetros de Âmbito diferentes de Forest.

Utilize o parâmetro MaxVersion juntamente com o parâmetro MinVersion apenas quando cria grupos de definições do Exchange através do comutador CreateSettingsGroup com o parâmetro GroupName.

Não pode utilizar este 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

O parâmetro MinVersion especifica o âmbito de um grupo de definições do Exchange com base na versão do objeto (por exemplo, a versão do Exchange que está instalada no servidor). Este parâmetro está disponível para utilização com todos os valores de parâmetros de Âmbito diferentes de Forest.

Utilize o parâmetro MinVersion juntamente com o parâmetro MaxVersion apenas quando criar grupos de definições do Exchange com o parâmetro CreateSettingsGroup com o parâmetro GroupName.

Não pode utilizar este 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

-NameMatch

Aplicável: Exchange Server 2016, Exchange Server 2019

O parâmetro NameMatch especifica o âmbito de um grupo de definições do Exchange com base no nome do objeto (por exemplo, o nome do processo). Este parâmetro está disponível para utilização com todos os valores de parâmetros de Âmbito diferentes de Forest.

Utiliza o parâmetro NameMatch apenas quando cria grupos de definições do Exchange com o comutador CreateSettingsGroup com o parâmetro GroupName.

Não pode utilizar este 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

O parâmetro Priority especifica a prioridade de um grupo de definições do Exchange. O valor de prioridade para cada grupo tem de 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

O parâmetro Reason especifica uma descrição do motivo pelo qual o grupo de definições ou definições do Exchange foi criado ou modificado. 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

O comutador RemoveSetting especifica que está a remover uma definição do Exchange existente de um objeto de definições do Exchange. Não é preciso especificar um valor com essa opção.

Utilize o parâmetro ConfigPairs ou o parâmetro ConfigName para especificar a definição que pretende 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

O comutador RemoveSettingsGroup especifica que está a remover um grupo de definições do Exchange. Não é preciso especificar um valor com essa opção.

Utilize o parâmetro GroupName para especificar o grupo de definições do Exchange que pretende 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

O parâmetro Âmbito especifica o âmbito do objeto de definições do Exchange. Os valores válidos são:

• Dag
• 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

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

• Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtráveis.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para igual e -like para comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators.
• Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas ('Value' ou '$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de '$User', utilize '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize 500, $true, $falseou $null em alternativa).

Pode encadear múltiplos critérios de pesquisa em conjunto com 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, veja Informações adicionais sobre sintaxe OPATH.

Não pode utilizar este parâmetro com o parâmetro Âmbito e o valor Floresta ou outros parâmetros relacionados com o âmbito.

Só utiliza este parâmetro quando atualiza os grupos de definições do Exchange através do comutador 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

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

Não pode utilizar 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

O comutador UpdateSetting especifica que está a atualizar uma definição do Exchange num objeto de definições do Exchange existente. Não é preciso especificar um valor com essa opção.

Utilize o parâmetro ConfigPairs ou os parâmetros ConfigName e ConfigValue para configurar a definiçã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

O comutador UpdateSettingsGroup especifica que está a modificar um grupo de definições do Exchange. Não é preciso especificar um valor com essa opção.

Consoante a forma como pretende configurar o grupo de definições, utilize o parâmetro GroupName ou o parâmetro SettingsGroup para especificar o grupo de definições do Exchange que pretende 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

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.

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.