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
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 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
In questo esempio viene richiesta conferma prima di disconnettersi da powershell Exchange Online o da PowerShell per la conformità & 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 sicurezza & conformità 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. Anche tutte le altre connessioni remote di PowerShell a Exchange Online PowerShell o a Security & Compliance PowerShell nella stessa finestra di Windows PowerShell vengono disconnesse.
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. Anche tutte le altre connessioni remote di PowerShell a Exchange Online PowerShell o a Security & Compliance PowerShell 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. 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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente 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 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.
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à: | False |
| 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 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.
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 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.
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.