Compartilhar via

Get-ConnectionInformation

Módulo:
Exchange PowerShell

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

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

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

Sintaxe

Default (Padrão) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

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

ModulePrefix 

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

Description

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

O resultado do cmdlet contém as seguintes propriedades:

  • ConnectionId: um valor GUID exclusivo para a ligação. Por exemplo, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Estado: por exemplo, Ligado.
  • ID: um número inteiro que identifica a sessão na janela do PowerShell. A primeira ligação é 1, a segunda é 2, etc.
  • Nome: um nome exclusivo baseado no ambiente do PowerShell e no valor de ID. Por exemplo, ExchangeOnline_1 para Exchange Online PowerShell ou ExchangeOnlineProtection_1 para o PowerShell de Conformidade & de Segurança.
  • UserPrincipalName: a conta que foi utilizada para ligar. Por exemplo, laura@contoso.onmicrosoft.com.
  • ConnectionUri: o ponto final de ligação que foi utilizado. Por exemplo, https://outlook.office365.com para Exchange Online PowerShell ou https://nam12b.ps.compliance.protection.outlook.com para o PowerShell de Conformidade do & de Segurança.
  • AzureAdAuthorizationEndpointUri: o ponto final de autorização Microsoft Entra para a ligação. Por exemplo, https://login.microsoftonline.com/organizations para Exchange Online PowerShell ou https://login.microsoftonline.com/organizations para o PowerShell de Conformidade do & de Segurança.
  • TokenExpiryTimeUTC: quando o token de ligação expira. Por exemplo, 30/09/2023 18:42:24 +00:00.
  • CertificateAuthentication: se a autenticação baseada em certificados (também conhecida como CBA ou autenticação apenas de aplicação) foi utilizada para ligar. Os valores são True ou False.
  • ModuleName: o nome de ficheiro 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 com o parâmetro Prefixo no comando Connect-ExchangeOnline ou Connect-IPPSSession.
  • Organização: o valor especificado com o parâmetro Organização no comando Connect-ExchangeOnline ou Connect-IPPSSession para a CBA ou ligações de identidade gerida.
  • DelegatedOrganization: o valor especificado com o parâmetro DelegatedOrganization no comando Connect-ExchangeOnline ou Connect-IPPSSession.
  • AppId: o valor especificado com o parâmetro AppId no comando Connect-ExchangeOnline ou Connect-IPPSSession para ligações CBA.
  • PageSize: o número máximo predefinido de entradas por página na ligação. O valor predefinido é 1000 ou pode utilizar o parâmetro PageSize no comando Connect-ExchangeOnline para especificar um número mais baixo. Os cmdlets individuais também podem ter um parâmetro PageSize.
  • TenantID: o valor GUID do ID do inquilino. Por exemplo, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: por exemplo, Ativo.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: para Exchange Online ligações do PowerShell, o valor é Falso. Para ligações do PowerShell de Conformidade & de Segurança, o valor é Verdadeiro.

Exemplos

Exemplo 1

Get-ConnectionInformation

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

Exemplo 2

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

Este exemplo devolve a ligação baseada em REST ativa com o valor ConnectionId especificado.

Exemplo 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

Este exemplo devolve uma lista de ligações baseadas em REST ativas que estão a utilizar os valores de prefixo especificados.

Parâmetros

-ConnectionId

Aplicável: Exchange Online

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

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

Não utilize este 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

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

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

Este parâmetro é significativo apenas para ligações que foram criadas com o parâmetro Prefixo.

Não utilize este 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.