Disconnect-ExchangeOnline
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.
Sintaxis
DefaultParameterSet (Es el 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 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
En 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
Aplicable: Exchange Online
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, 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. 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 3.2.0-Preview2 del módulo o posterior.
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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ConnectionId
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ModulePrefix
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión 3.2.0-Preview2 del módulo o posterior.
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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ModulePrefix
| Posición: | Named |
| Mandatory: | 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 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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.