Compartilhar via


Get-EXOCasMailbox

Esse cmdlet está disponível apenas no módulo Exchange Online PowerShell. Para obter mais informações, consulte Sobre o módulo Exchange Online PowerShell.

Use o cmdlet Get-EXOCasMailbox para exibir as configurações de Acesso ao Cliente configuradas em caixas de correio.

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

Syntax

Get-EXOCasMailbox
   [[-Identity] <String>]
   [-ActiveSyncDebugLogging]
   [-ExternalDirectoryObjectId <Guid>]
   [-Filter <String>]
   [-GetImapProtocolLog]
   [-GetPopProtocolLog]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <String>]
   [-PrimarySmtpAddress <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-ProtocolSettings]
   [-ReadIsOptimizedForAccessibility]
   [-ResultSize <Unlimited>]
   [-SendLogsTo <String[]>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]
Get-EXOCasMailbox
   [-Anr <String>]
   [-ActiveSyncDebugLogging]
   [-Filter <String>]
   [-GetImapProtocolLog]
   [-GetPopProtocolLog]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-ProtocolSettings]
   [-ReadIsOptimizedForAccessibility]
   [-ResultSize <Unlimited>]
   [-SendLogsTo <String[]>]
   [<CommonParameters>]

Description

Esse cmdlet retorna diversas configurações de acesso de cliente para uma ou mais caixas de correio. Essas configurações incluem opções para Outlook na Web, Exchange ActiveSync, POP3 e IMAP4.

Exemplos

Exemplo 1

Get-EXOCASMailbox -Identity "JeffHay@contoso.com"

Este exemplo retorna os valores das seguintes configurações de acesso ao cliente para o usuário com Identidade Jeffhay@contoso.com:

  • ActiveSyncEnabled
  • EwsEnabled
  • OWAEnabled
  • PopEnabled
  • ImapEnabled
  • MAPIEnabled
  • ECPEnabled

Parâmetros

-ActiveSyncDebugLogging

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Anr

O parâmetro Anr especifica uma cadeia de caracteres na qual executar uma pesquisa ANR (resolução de nomes ambíguos). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisados são:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • Sobrenome
  • Alias

Você não pode usar esse parâmetro com os parâmetros ExternalDirectoryObjectId, Identity, PrimarySmtpAddress ou UserPrincipalName.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExternalDirectoryObjectId

O parâmetro ExternalDirectoryObjectId identifica a caixa de correio que você deseja exibir pelo ObjectId no Azure Active Directory.

Você não pode usar esse parâmetro com os parâmetros Anr, Identity, PrimarySmtpAddress ou UserPrincipalName.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Filter

O parâmetro Filter usa a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

  • Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrada. Para obter mais informações sobre as propriedades filtradas, consulte Conjuntos de propriedades Get-EXOCasMailbox e propriedades filtreáveis para o parâmetro Filter.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
  • Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando 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, consulte Informações adicionais de sintaxe OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-GetImapProtocolLog

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-GetPopProtocolLog

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

O parâmetro Identity especifica a caixa de correio que você deseja exibir. Para obter o melhor desempenho, recomendamos usar os seguintes valores:

  • ID de usuário ou nome UPN
  • GUID

Caso contrário, você pode usar qualquer outro valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • LegacyExchangeDN
  • SamAccountName

Você não pode usar esse parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-IgnoreDefaultScope

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OrganizationalUnit

O parâmetro OrganizationalUnit filtra os resultados com base na localização do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio que fique visível na utilização do cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome
  • Nome
  • Nome diferenciado (DN)
  • GUID
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

O PrimarySmtpAddress identifica a caixa de correio que você deseja exibir por endereço de email SMTP primário (por exemplo, navin@contoso.com).

Você não pode usar esse parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, Identity ou UserPrincipalName.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Properties

O parâmetro Propriedades especifica as propriedades retornadas na saída desse cmdlet. Vários valores, separados por vírgulas, podem ser especificados.

Para obter mais informações sobre as propriedades disponíveis, consulte Conjuntos de propriedades Get-EXOCasMailbox.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PropertySets

O parâmetro PropertySets especifica um agrupamento lógico de propriedades que são retornadas na saída desse cmdlet. Os valores válidos são:

  • Mínimo (este é o valor padrão)
  • ActiveSync
  • Ews
  • Imap
  • Mapi
  • Pop
  • ProtocolSettings
  • Todos

Vários valores, separados por vírgulas, podem ser especificados.

Para obter mais informações sobre as propriedades incluídas em cada conjunto de propriedades, confira Conjuntos de propriedades Get-EXOCasMailbox.

Type:PropertySet[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ProtocolSettings

A opção ProtocolSettings retorna os nomes de servidor, as portas TCP e os métodos de criptografia para as seguintes configurações:

  • ExternalImapSettings
  • InternalImapSettings
  • ExternalPopSettings
  • InternalPopSettings
  • ExternalSmtpSettings
  • InternalSmtpSettings

Não é preciso especificar um valor com essa opção.

Para ver esses valores, você precisa usar um cmdlet de formatação. Por exemplo, Get-CasMailbox laura@contoso.com -ProtocolSettings | Format-List.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReadIsOptimizedForAccessibility

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SendLogsTo

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserPrincipalName

O parâmetro UserPrincipalName identifica a caixa de correio que você deseja exibir por UPN (por exemplo, navin@contoso.onmicrosoft.com).

Você não pode usar esse parâmetro com os parâmetros Anr, ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

Entradas

Input types

Os seguintes parâmetros de Get-CasMailbox não estão disponíveis ou têm suporte no Get-EXOCasMailbox:

  • IgnoreDefaultScope
  • ReadIsOptimizedForAccessibility
  • SortBy

Saídas

Output types

As seguintes propriedades são removidas por design de Get-EXOCasMailbox saída:

  • RunspaceId
  • Servername
  • OriginatingServer
  • IsValid