Disconnect-ExchangeOnline
Este cmdlet solo está disponible en el módulo de PowerShell de Exchange Online. Para obtener más información, consulte Acerca del módulo de PowerShell de Exchange Online.
Use el cmdlet Disconnect-ExchangeOnline del módulo de PowerShell Exchange Online para desconectar las conexiones que creó con 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.
Sintaxis
DefaultParameterSet (valor predeterminado)
Disconnect-ExchangeOnline
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ConnectionId
Disconnect-ExchangeOnline
-ConnectionId <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
ModulePrefix
Disconnect-ExchangeOnline
-ModulePrefix <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet es la contraparte de los cmdlets Connect-ExchangeOnline y Connect-IPPSSession.
Este cmdlet desconecta 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 perfil de la cuenta que usó para conectarse contiene caracteres especiales de PowerShell (por ejemplo, $). La solución alternativa es 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 pide confirmación antes de desconectarse de Exchange Online PowerShell o de PowerShell de cumplimiento de & de seguridad.
Ejemplo 2
Disconnect-ExchangeOnline -Confirm:$false
En este ejemplo se desconecta de forma silenciosa de Exchange Online PowerShell o PowerShell de cumplimiento de & de seguridad sin un mensaje de confirmación o cualquier texto de notificación.
Ejemplo 3
Disconnect-ExchangeOnline -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85
En este ejemplo se desconecta la conexión de PowerShell de Exchange Online basada en REST con el valor ConnectionId especificado. Cualquier otra conexión remota de PowerShell a Exchange Online PowerShell o Security & Compliance PowerShell en la misma ventana de Windows PowerShell también se desconecta.
Ejemplo 4
Disconnect-ExchangeOnline -ModulePrefix Contoso,Fabrikam
En este ejemplo se desconectan las conexiones de PowerShell de Exchange Online basadas en REST que usan los valores de prefijo especificados. Cualquier otra conexión remota de PowerShell a Exchange Online PowerShell o Security & Compliance PowerShell en la misma ventana de Windows PowerShell también se desconecta.
Parámetros
-Confirm
Aplicable: Exchange Online
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los 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 otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConnectionId
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.2.0-Preview2 o posterior.
El parámetro ConnectionId especifica las conexiones de API de REST que se van a desconectar mediante ConnectionId. 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 de ConnectionId separados por comas.
No use este parámetro con el parámetro ModulePrefix.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ConnectionId
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-ModulePrefix
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.2.0-Preview2 o posterior.
El parámetro ModulePrefix especifica las conexiones de API de REST que se van a desconectar mediante ModulePrefix. Cuando se usa el parámetro Prefijo con el cmdlet de 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ModulePrefix
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Online
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.