Compartilhar via


Get-ConnectionInformation

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

Use o cmdlet Get-ConnectionInformation para obter informações sobre todas as conexõ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.

Syntax

Get-ConnectionInformation []
Get-ConnectionInformation
   -ConnectionId <String[]>
   [<CommonParameters>]
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.

Exemplos

Exemplo 1

Get-ConnectionInformation

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

Exemplo 2

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

Este exemplo retorna a conexão baseada em REST ativa com o valor 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

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

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

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ModulePrefix

Observação: esse parâmetro está disponível na versão 3.2.0 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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False