Disconnect-ExchangeOnline
Este cmdlet só está disponível no módulo Exchange Online PowerShell. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.
Utilize o cmdlet Disconnect-ExchangeOnline no módulo Exchange Online PowerShell para desligar as ligações que criou com 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 (Padrão)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet é o equivalente aos cmdlets Connect-ExchangeOnline e Connect-IPPSSession.
Este cmdlet desliga todas as ligações e limpa a cache. Após uma desconexão bem-sucedida, não pode executar com êxito cmdlets para a sua organização.
Os comandos de desconexão provavelmente falharão se o caminho do perfil da conta que utilizou para ligar contiver carateres especiais do PowerShell (por exemplo, $). A solução é ligar com uma conta diferente que não tenha carateres especiais no caminho do perfil.
Exemplos
Exemplo 1
Disconnect-ExchangeOnline
Este exemplo pede confirmação antes de desligar do PowerShell do Exchange Online PowerShell ou do PowerShell de Conformidade do & de Segurança.
Exemplo 2
Disconnect-ExchangeOnline -Confirm:$false
Este exemplo desliga-se automaticamente do PowerShell Exchange Online PowerShell ou do PowerShell de Conformidade do & de Segurança sem um pedido de confirmação ou qualquer texto de notificação.
Exemplo 3
Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85
Este exemplo desliga a ligação baseada em REST Exchange Online PowerShell com o valor ConnectionId especificado. Quaisquer outras ligações remotas do PowerShell para Exchange Online PowerShell ou o PowerShell de Conformidade do & de Segurança na mesma janela de Windows PowerShell também estão desligadas.
Exemplo 4
Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam
Este exemplo desliga as ligações baseadas em REST Exchange Online PowerShell que estão a utilizar os valores de prefixo especificados. Quaisquer outras ligações remotas do PowerShell para Exchange Online PowerShell ou o PowerShell de Conformidade do & de Segurança na mesma janela de Windows PowerShell também estão desligadas.
Parâmetros
-Confirm
Aplicável: Exchange Online
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, 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 confirmar 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
Nota: este parâmetro está disponível na versão do módulo 3.2.0-Preview2 ou posterior.
O parâmetro ConnectionId especifica as ligações da API REST para desligar 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 especifica as ligações da API REST para desligar 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.
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 |
-WhatIf
Aplicável: Exchange Online
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.
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 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.