Disconnect-ExchangeOnline

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

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 Disconnect-ExchangeOnline no módulo Exchange Online PowerShell para desconectar as conexões criadas usando os cmdlets Connect-ExchangeOnline ou Connect-IPPSSession.

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

Syntax

Disconnect-ExchangeOnline
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]
Disconnect-ExchangeOnline
          -ConnectionId <String[]>
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]
Disconnect-ExchangeOnline
          -ModulePrefix <String[]>
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]

Description

Esse cmdlet é o equivalente aos cmdlets Connect-ExchangeOnline e Connect-IPPSSession.

Esse cmdlet desconecta todas as conexões e limpa o cache. Depois de uma desconexão bem-sucedida, você não pode executar com êxito nenhum cmdlets para sua organização.

Os comandos de desconexão provavelmente falharão se o caminho de perfil da conta que você usou para se conectar contiver caracteres especiais do PowerShell (por exemplo, $). A solução alternativa é conectar-se usando uma conta diferente que não tenha caracteres especiais no caminho do perfil.

Exemplos

Exemplo 1

Disconnect-ExchangeOnline

Este exemplo pede confirmação antes de se desconectar do PowerShell ou do PowerShell de Conformidade de Segurança & do Exchange Online.

Exemplo 2

Disconnect-ExchangeOnline -Confirm:$false

Este exemplo desconecta-se silenciosamente de Exchange Online PowerShell ou Do PowerShell de Conformidade de Segurança & sem um prompt de confirmação ou qualquer texto de notificação.

Exemplo 3

Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

Este exemplo desconecta a conexão Exchange Online PowerShell baseada em REST com o valor ConnectionId especificado. Outras conexões remotas do PowerShell com Exchange Online PowerShell ou PowerShell de Conformidade de Segurança & na mesma janela Windows PowerShell também são desconectadas.

Exemplo 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

Este exemplo desconecta as conexões do PowerShell Exchange Online baseadas em REST que estão usando os valores de prefixo especificados. Outras conexões remotas do PowerShell com Exchange Online PowerShell ou PowerShell de Conformidade de Segurança & na mesma janela Windows PowerShell também são desconectadas.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConnectionId

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

O parâmetro ConnectionId especifica as conexões de API REST para desconectar 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 especifica as conexões de API REST para desconectar 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.

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

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

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