Condividi tramite


Disconnect-ExchangeOnline

Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.

Usare il cmdlet Disconnect-ExchangeOnline nel modulo powershell Exchange Online per disconnettere le connessioni create usando i cmdlet Connect-ExchangeOnline o Connect-IPPSSession.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Questo cmdlet è la controparte dei cmdlet Connect-ExchangeOnline e Connect-IPPSSession.

Questo cmdlet disconnette tutte le connessioni e cancella la cache. Dopo una disconnessione riuscita, non è possibile eseguire correttamente alcun cmdlet per l'organizzazione.

È probabile che i comandi di disconnessione non riescano se il percorso del profilo dell'account usato per la connessione contiene caratteri di PowerShell speciali , $ad esempio . La soluzione alternativa consiste nel connettersi usando un account diverso che non include caratteri speciali nel percorso del profilo.

Esempio

Esempio 1

Disconnect-ExchangeOnline

Questo esempio richiede conferma prima di disconnettersi da Exchange Online PowerShell o da PowerShell per la conformità alla sicurezza&.

Esempio 2

Disconnect-ExchangeOnline -Confirm:$false

Questo esempio si disconnette in modo invisibile all'utente da Exchange Online PowerShell o da PowerShell per la conformità alla sicurezza & senza una richiesta di conferma o testo di notifica.

Esempio 3

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

Questo esempio disconnette la connessione PowerShell Exchange Online basata su REST con il valore ConnectionId specificato. Vengono disconnesse anche tutte le altre connessioni remote di PowerShell a Exchange Online PowerShell o a Conformità alla sicurezza & di PowerShell nella stessa finestra di Windows PowerShell.

Esempio 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

Questo esempio disconnette le connessioni PowerShell Exchange Online basate su REST che usano i valori di prefisso specificati. Vengono disconnesse anche tutte le altre connessioni remote di PowerShell a Exchange Online PowerShell o a Conformità alla sicurezza & di PowerShell nella stessa finestra di Windows PowerShell.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ConnectionId

Nota: questo parametro è disponibile nella versione 3.2.0 o successiva del modulo.

Il parametro ConnectionId consente di specificare le connessioni API REST da disconnettere da ConnectionId. ConnectionId è un valore GUID nell'output del cmdlet Get-ConnectionInformation che identifica in modo univoco una connessione, anche se sono aperte più connessioni. È possibile specificare più valori ConnectionId separati da virgole.

Non usare questo parametro con il parametro ModulePrefix.

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

-ModulePrefix

Nota: questo parametro è disponibile nella versione 3.2.0 o successiva del modulo.

Il parametro ModulePrefix consente di specificare le connessioni API REST da disconnettere da ModulePrefix. Quando si usa il parametro Prefix con il cmdlet Connect-ExchangeOnline, il testo specificato viene aggiunto ai nomi di tutti i cmdlet Exchange Online, ad esempio Get-InboundConnector diventa Get-ContosoInboundConnector. Il valore ModulePrefix è visibile nell'output del cmdlet Get-ConnectionInformation. È possibile specificare più valori ModulePrefix separati da virgole.

Non usare questo parametro con il parametro ConnectionId.

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

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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