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 |