Get-ExchangeSettings

Módulo:
Exchange PowerShell

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

Use o cmdlet Get-ExchangeSettings para exibir objetos de configuração personalizados do Exchange que estão armazenados no Active Directory. Use o New-ExchangeSettings para criar o objeto de configurações e o cmdlet Set-ExchangeSettings para definir as configurações reais.

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

Sintaxe

Default (Default) 

Get-ExchangeSettings
    [[-Identity] <ExchangeSettingsIdParameter>]
    [-ConfigName <String>]
    [-Database <DatabaseIdParameter>]
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Force]
    [-GenericScopeName <String>]
    [-GenericScopes <String[]>]
    [-GenericScopeValue <String>]
    [-Organization <OrganizationIdParameter>]
    [-Process <String>]
    [-Server <ServerIdParameter>]
    [-User <Guid>]
    [<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

Get-ExchangeSettings

Este exemplo retorna uma lista resumida de todos os objetos de configuração do Exchange.

Exemplo 2

Get-ExchangeSettings -Identity Audit | Format-List

Este exemplo retorna uma lista resumida de todos os objetos de configuração do Exchange.

Parâmetros

-ConfigName

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

O parâmetro ConfigName filtra os resultados pelo nome de propriedade especificado. O valor especificado é visível na propriedade EffectiveSetting.

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

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

-Database

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

O parâmetro Database filtra os resultados por banco de dados de caixa de correio. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • ExchangeLegacyDN
  • GUID

Propriedades do parâmetro

Tipo:DatabaseIdParameter
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

-Diagnostic

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

A opção Diagnostic especifica quando é necessário retornar informações extremamente detalhadas nos resultados. Não é preciso especificar um valor com essa opção.

As informações detalhadas são visíveis na propriedade DiagnosticInfo.

Normalmente, você usa essa opção somente por solicitação do Suporte e Atendimento ao Cliente Microsoft para solucionar problemas.

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

-DiagnosticArgument

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

O parâmetro DiagnosticArgument modifica os resultados retornados usando a opção Diagnostic. Normalmente, você usa a opção Diagnostic e o parâmetro DiagnosticArgument somente por solicitação do Serviço de Suporte e Atendimento ao Cliente Microsoft para solucionar problemas.

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

-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 filtra os resultados pelo 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

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

-GenericScopes

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

O parâmetro GenericScopes filtra os resultados pelo escopo. Os valores disponíveis são determinados pelo esquema do objeto de configuração do Exchange. Esse parâmetro usa a sintaxe "key1=value1","key2=value2", "keyN=valueN.

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: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 filtra os resultados pelo 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

(All)
Cargo:Named
Obrigatório:False
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ção do Exchange. É possível usar qualquer valor que identifique o objeto com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.

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:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Organization

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

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:OrganizationIdParameter
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

-Process

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

O parâmetro Process filtra os resultados pelo processo especificado. 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

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

-Server

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

O parâmetro Server filtra os resultados por servidor Exchange. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • ExchangeLegacyDN
  • GUID

Propriedades do parâmetro

Tipo:ServerIdParameter
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

-User

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

O parâmetro User filtra os resultados por usuário. Você identifica o usuário pelo valor GUID (por exemplo, 87246450-1b19-4c81-93dc-1a4200eff66c). Para localizar o GUID de um usuário, execute o seguinte comando: Get-User <UserIdentity> | Format-List Name,GUID.

Propriedades do parâmetro

Tipo:Guid
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

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.