Disconnect-ExchangeOnline
Questo cmdlet è disponibile solo nel modulo PowerShell di Exchange Online. Per ulteriori informazioni, vedere Informazioni sul modulo PowerShell di Exchange Online.
Usare il cmdlet Disconnect-ExchangeOnline nel modulo Exchange Online PowerShell 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
DefaultParameterSet (Impostazione predefinita)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Descrizione
Questo cmdlet è la controparte dei cmdlet di 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.
I comandi di disconnessione avranno probabilmente esito negativo se il percorso del profilo dell'account utilizzato per la connessione contiene caratteri speciali di PowerShell, $ad esempio ). La soluzione alternativa consiste nel connettersi usando un account diverso che non contenga caratteri speciali nel percorso del profilo.
Esempio
Esempio 1
Disconnect-ExchangeOnline
Questo esempio chiede conferma prima di disconnettersi da PowerShell o da Exchange Online PowerShell per la sicurezza & la conformità.
Esempio 2
Disconnect-ExchangeOnline -Confirm:$false
Questo esempio si disconnette automaticamente da Exchange Online PowerShell o da PowerShell per la sicurezza & la conformità senza una richiesta di conferma o un testo di notifica.
Esempio 3
Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85
In questo esempio la connessione di Exchange Online PowerShell basata su REST viene disconnessa con il valore ConnectionId specificato. Anche tutte le altre connessioni remote di PowerShell a PowerShell o a Exchange Online PowerShell per la sicurezza & la conformità nella stessa finestra di Windows PowerShell vengono disconnesse.
Esempio 4
Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam
In questo esempio vengono disconnesse le connessioni PowerShell di Exchange Online basate su REST che usano i valori di prefisso specificati. Anche tutte le altre connessioni remote di PowerShell a PowerShell o a Exchange Online PowerShell per la sicurezza & la conformità nella stessa finestra di Windows PowerShell vengono disconnesse.
Parametri
-Confirm
Applicabile: Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ConnectionId
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.2.0-Preview2 o successiva.
Il parametro ConnectionId specifica le connessioni API REST da disconnettere tramite 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ConnectionId
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ModulePrefix
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.2.0-Preview2 o successiva.
Il parametro ModulePrefix specifica le connessioni API REST da disconnettere tramite 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ModulePrefix
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Online
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.