Disconnect-ExchangeOnline

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Online

Este cmdlet solo está disponible en el módulo de PowerShell Exchange Online. Para obtener más información, vea Acerca de la Exchange Online módulo de PowerShell.

Use el cmdlet Disconnect-ExchangeOnline del módulo de PowerShell Exchange Online para desconectar las conexiones que creó mediante los cmdlets Connect-ExchangeOnline o Connect-IPPSSession.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Disconnect-ExchangeOnline
          [-Confirm]
          [-WhatIf]
          [<CommonParameters>]

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

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

Description

Este cmdlet es el homólogo de los cmdlets Connect-ExchangeOnline y Connect-IPPSSession.

Este cmdlet desconecta todas las conexiones y borra la memoria caché. Después de una desconexión correcta, no puede ejecutar correctamente ningún cmdlet para su organización.

Es probable que se produzca un error en los comandos de desconexión si la ruta de acceso del perfil de la cuenta que usó para conectarse contiene caracteres especiales de PowerShell (por ejemplo, $). La solución alternativa consiste en conectarse con una cuenta diferente que no tenga caracteres especiales en la ruta de acceso del perfil.

Ejemplos

Ejemplo 1

Disconnect-ExchangeOnline

En este ejemplo se solicita confirmación antes de desconectarse de Exchange Online PowerShell o PowerShell de cumplimiento de seguridad&.

Ejemplo 2

Disconnect-ExchangeOnline -Confirm:$false

Este ejemplo se desconecta silenciosamente de Exchange Online PowerShell o PowerShell de cumplimiento de seguridad & sin un mensaje de confirmación ni ningún texto de notificación.

Ejemplo 3

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

En este ejemplo se desconecta la conexión de PowerShell Exchange Online basada en REST con el valor connectionId especificado. También se desconecta cualquier otra conexión remota de PowerShell a Exchange Online PowerShell o PowerShell de cumplimiento de seguridad & en la misma ventana de Windows PowerShell.

Ejemplo 4

Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam

En este ejemplo se desconectan las conexiones de PowerShell Exchange Online basadas en REST que usan los valores de prefijo especificados. También se desconecta cualquier otra conexión remota de PowerShell a Exchange Online PowerShell o PowerShell de cumplimiento de seguridad & en la misma ventana de Windows PowerShell.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

• Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
• La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

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: Este parámetro está disponible en la versión 3.2.0 o posterior del módulo.

El parámetro ConnectionId especifica las conexiones de la API REST que connectionid desconectará. ConnectionId es un valor GUID en la salida del cmdlet Get-ConnectionInformation que identifica de forma única una conexión, incluso si tiene varias conexiones abiertas. Puede especificar varios valores ConnectionId separados por comas.

No use este parámetro con el parámetro ModulePrefix.

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

-ModulePrefix

Nota: Este parámetro está disponible en la versión 3.2.0 o posterior del módulo.

El parámetro ModulePrefix especifica las conexiones de API REST que se desconectarán mediante ModulePrefix. Cuando se usa el parámetro Prefix con el cmdlet Connect-ExchangeOnline, el texto especificado se agrega a los nombres de todos los cmdlets de Exchange Online (por ejemplo, Get-InboundConnector se convierte en Get-ContosoInboundConnector). El valor ModulePrefix está visible en la salida del cmdlet Get-ConnectionInformation. Puede especificar varios valores ModulePrefix separados por comas.

No use este parámetro con el parámetro ConnectionId.

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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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