Disconnect-ExchangeOnline
Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.
Use o cmdlet Disconnect-ExchangeOnline no módulo Exchange Online PowerShell para desconectar as conexões que você criou 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.
Sintaxe
DefaultParameterSet (Default)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Esse cmdlet é a contrapartida dos cmdlets Connect-ExchangeOnline e Connect-IPPSSession.
Esse cmdlet desconecta todas as conexões e limpa o cache. Após uma desconexão bem-sucedida, você não poderá executar nenhum cmdlet com êxito para sua organização.
Os comandos de desconexão provavelmente falharão se o caminho do perfil da conta usada para 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 solicita confirmação antes de se desconectar Exchange Online PowerShell ou do PowerShell de Segurança & Conformidade.
Exemplo 2
Disconnect-ExchangeOnline -Confirm:$false
Este exemplo se desconecta silenciosamente do PowerShell ou do PowerShell Exchange Online Conformidade de Segurança & sem uma solicitação 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 do PowerShell do Exchange Online baseada em REST com o valor de ConnectionId especificado. Todas as outras conexões remotas do PowerShell com Exchange Online PowerShell ou o PowerShell de Segurança & Conformidade 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 do Exchange Online baseadas em REST que estão usando os valores de prefixo especificados. Todas as outras conexões remotas do PowerShell com Exchange Online PowerShell ou o PowerShell de Segurança & Conformidade na mesma janela Windows PowerShell também são desconectadas.
Parâmetros
-Confirm
Aplicável: Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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 especifica as conexões da API REST a serem desconectadas 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: | True |
| 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 especifica as conexões da API REST a serem desconectadas 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.
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 |
-WhatIf
Aplicável: Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| 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.