Get-ExchangeSettings
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Get-ExchangeSettings para exibir objetos personalizados de configuração do Exchange 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.
Syntax
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 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
Get-ExchangeSettingsEste exemplo retorna uma lista de resumo de todos os objetos de configuração do Exchange.
Exemplo 2
Get-ExchangeSettings -Identity Audit | Format-ListEste exemplo retorna uma lista de resumo de todos os objetos de configuração do Exchange.
Parâmetros
-ConfigName
O parâmetro ConfigName filtra os resultados pelo nome da 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.
| 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 |
-Database
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
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Diagnostic
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 estã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.
| 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 |
-DiagnosticArgument
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.
| 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 |
-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 filtra os resultados pelo 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 |
-GenericScopes
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.
| 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 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.
| 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 |
-Identity
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
| Type: | ExchangeSettingsIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Organization
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | OrganizationIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Process
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.
| 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 |
-Server
O parâmetro Server filtra os resultados pelo servidor exchange. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- ExchangeLegacyDN
- GUID
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-User
O parâmetro Usuário 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 para um usuário, execute o seguinte comando: Get-User <UserIdentity> | Format-List Name,GUID.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários