Get-ConnectionInformation

Módulo:
Exchange PowerShell

Este cmdlet está disponível apenas no módulo do PowerShell do Exchange Online versão 3.0.0 ou posterior. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.

Use o cmdlet Get-ConnectionInformation para obter informações sobre todas as conexões baseadas em REST na instância atual do PowerShell com o Exchange Online.

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

Sintaxe

Default (Default) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

Get-ConnectionInformation
    -ConnectionId <String[]>
    [<CommonParameters>]

ModulePrefix 

Get-ConnectionInformation
    -ModulePrefix <String[]>
    [<CommonParameters>]

Description

O cmdlet Get-ConnectionInformation retorna as informações sobre todas as conexões ativas baseadas em REST com Exchange Online na instância atual do PowerShell. Esse cmdlet é equivalente ao cmdlet Get-PSSession usado com sessões remotas do PowerShell.

A saída do cmdlet contém as seguintes propriedades:

  • ConnectionId: um valor GUID exclusivo para a conexão. Por exemplo, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Estado: Por exemplo, Conectado.
  • Id: um número inteiro que identifica a sessão na janela do PowerShell. A primeira conexão é 1, a segunda é 2, etc.
  • Nome: um nome exclusivo baseado no ambiente do PowerShell e no valor da ID. Por exemplo, ExchangeOnline_1 para Exchange Online PowerShell ou ExchangeOnlineProtection_1 para o PowerShell de Segurança & Conformidade.
  • UserPrincipalName: a conta que foi usada para se conectar. Por exemplo, laura@contoso.onmicrosoft.com.
  • ConnectionUri: o ponto de extremidade de conexão usado. Por exemplo, https://outlook.office365.com para Exchange Online o PowerShell ou https://nam12b.ps.compliance.protection.outlook.com para o PowerShell de Segurança & Conformidade.
  • AzureAdAuthorizationEndpointUri: o ponto de extremidade de autorização do Microsoft Entra para a conexão. Por exemplo, https://login.microsoftonline.com/organizations para Exchange Online o PowerShell ou https://login.microsoftonline.com/organizations para o PowerShell de Segurança & Conformidade.
  • TokenExpiryTimeUTC: quando o token de conexão expirar. Por exemplo, 30/09/2023 18:42:24 +00:00.
  • CertificateAuthentication: se a autenticação baseada em certificado (também conhecida como CBA ou autenticação somente de aplicativo) foi usada para se conectar. Os valores são True ou False.
  • ModuleName: o nome do arquivo e o caminho dos dados temporários da sessão. Por exemplo, C:\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix: o valor especificado usando o parâmetro Prefix no comando Connect-ExchangeOnline ou Connect-IPPSSession.
  • Organização: o valor especificado usando o parâmetro Organization no comando Connect-ExchangeOnline ou Connect-IPPSSession para conexões CBA ou de identidade gerenciada.
  • DelegatedOrganization: o valor especificado usando o parâmetro DelegatedOrganization no comando Connect-ExchangeOnline ou Connect-IPPSSession.
  • AppId: O valor especificado usando o parâmetro AppId no comando Connect-ExchangeOnline ou Connect-IPPSSession para conexões CBA.
  • PageSize: o número máximo padrão de entradas por página na conexão. O valor padrão é 1000 ou você pode usar o parâmetro PageSize no comando Connect-ExchangeOnline para especificar um número menor. Cmdlets individuais também podem ter um parâmetro PageSize.
  • TenantID: o valor GUID da ID do locatário. Por exemplo, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: Por exemplo, Ativo.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: para conexões do PowerShell do Exchange Online, o valor é False. Para conexões do PowerShell de Segurança & Conformidade, o valor é True.

Exemplos

Exemplo 1

Get-ConnectionInformation

Este exemplo retorna uma lista de todas as conexões ativas baseadas em REST com o Exchange Online na instância atual do PowerShell.

Exemplo 2

Get-ConnectionInformation -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

Este exemplo retorna a conexão ativa baseada em REST com o valor de ConnectionId especificado.

Exemplo 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

Este exemplo retorna uma lista de conexões ativas baseadas em REST que estão usando os valores de prefixo especificados.

Parâmetros

-ConnectionId

Aplicável: Exchange Online

Observação: este parâmetro está disponível na versão 3.2.0-Preview2 ou posterior do módulo.

O parâmetro ConnectionId filtra as conexões por ConnectionId. ConnectionId é um valor GUID na saída do cmdlet do Get-ConnectionInformation que identifica exclusivamente uma conexão, mesmo que você tenha várias conexões abertas. Você pode especificar vários valores de ConnectionId separados por vírgulas.

Não use esse parâmetro com o parâmetro ModulePrefix.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ConnectionId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ModulePrefix

Aplicável: Exchange Online

Observação: este parâmetro está disponível na versão 3.2.0-Preview2 ou posterior do módulo.

O parâmetro ModulePrefix filtra as conexões por ModulePrefix. Quando você usa o parâmetro Prefix com o cmdlet Connect-ExchangeOnline, o texto especificado é adicionado aos nomes de todos os cmdlets Exchange Online (por exemplo, Get-InboundConnector se torna Get-ContosoInboundConnector). O valor ModulePrefix é visível na saída do cmdlet Get-ConnectionInformation. Você pode especificar vários valores ModulePrefix separados por vírgulas.

Esse parâmetro é significativo apenas para conexões que foram criadas com o parâmetro Prefix.

Não use esse parâmetro com o parâmetro ConnectionId.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ModulePrefix
Cargo:Named
Obrigatório:True
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.