Get-ClientAccessServer
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Get-ClientAccessServer para exibir as configurações que estão associadas com a função de servidor de acesso para cliente.
Observação: no Exchange 2013 ou posterior, use o cmdlet Get-ClientAccessService. Se você tiver scripts que usam Get-ClientAccessServer, atualize-os para usar Get-ClientAccessService.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-ClientAccessServer
[[-Identity] <ClientAccessServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeAlternateServiceAccountCredentialPassword]
[-IncludeAlternateServiceAccountCredentialStatus]
[<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-ClientAccessServer
Este exemplo retorna uma lista resumida de todos os servidores Exchange em sua organização que têm a função de servidor Acesso para Cliente instalada.
Exemplo 2
Get-ClientAccessServer -Identity mail.contoso.com | Format-List
Este exemplo retorna informações detalhadas do servidor mail.contoso.com.
Parâmetros
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, 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 |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Identity especifica o servidor com a função de servidor de acesso para cliente que você deseja exibir.
É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- É possível usar qualquer valor que identifique o servidor com exclusividade, por exemplo:
- Nome (por exemplo: Exchange01)
- DN (nome diferenciado) (por exemplo, CN=Exchange01,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,CN=First Organization,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=contoso,DC=com)
- DN Herdado do Exchange (por exemplo, /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01)
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: | ClientAccessServerIdParameter |
| 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 |
-IncludeAlternateServiceAccountCredentialPassword
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção IncludeAlternateServiceAccountCredentialPassword especifica se a senha da conta de serviço alternativo deve ser incluída nos resultados. Não é preciso especificar um valor com essa opção.
A senha fica visível na propriedade AlternateServiceAccountConfiguration. Para ver essa propriedade, use o cmdlet Format-List. Por exemplo, Get-ClientAccessServer <ServerIdentity> | Format-List AlternateServiceAccountConfiguration.
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 |
-IncludeAlternateServiceAccountCredentialStatus
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro IncludeAlternateServiceAccountCredentialStatus especifica se o status da conta de serviço alternativo deve ser incluída nos resultados. Não é preciso especificar um valor com essa opção.
O status fica visível na propriedade AlternateServiceAccountConfiguration. Para ver essa propriedade, use o cmdlet Format-List. Por exemplo, Get-ClientAccessServer <ServerIdentity> | Format-List AlternateServiceAccountConfiguration.
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 |
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.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.