Connect-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 Connect-ExchangeOnline en el módulo de PowerShell Exchange Online para conectarse a Exchange Online PowerShell o a powerShell independiente Exchange Online Protection mediante la autenticación moderna. Este cmdlet funciona para cuentas con o sin autenticación multifactor (MFA).
Para conectarse a Security & Compliance PowerShell, use el cmdlet 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
Connect-ExchangeOnline
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-ExchangeEnvironmentName] <ExchangeEnvironment>]
[[-PSSessionOption] <PSSessionOption>]
[[-DelegatedOrganization] <String>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Device]
[-EnableErrorReporting]
[-InlineCredential]
[-LoadCmdletHelp]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-ManagedIdentity]
[-ManagedIdentityAccountId <String>]
[-Organization <String>]
[-PageSize <UInt32>]
[-ShowBanner]
[-ShowProgress <Boolean>]
[-SigningCertificate <X509Certificate2>]
[-SkipLoadingCmdletHelp]
[-SkipLoadingFormatData]
[-TrackPerformance <Boolean>]
[-UseMultithreading <Boolean>]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Description
Este cmdlet crea una conexión de PowerShell a la organización Exchange Online.
Es probable que se produzca un error en los comandos de conexió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
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com
En este ejemplo se conecta a Exchange Online PowerShell mediante la autenticación moderna, con o sin autenticación multifactor (MFA). La conexión usa el modo de API REST y no requiere que la autenticación básica esté habilitada en WinRM en el equipo local.
Ejemplo 2
Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
Este ejemplo se conecta a Exchange Online PowerShell en un escenario de scripting desatendido mediante una huella digital de certificado.
Ejemplo 3
Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
En este ejemplo se conecta a Exchange Online PowerShell en un escenario de scripting desatendido mediante un archivo de certificado. Este método es más adecuado para escenarios en los que el certificado se almacena en máquinas remotas y se captura en tiempo de ejecución. Por ejemplo, el certificado se almacena en azure Key Vault.
Ejemplo 4
Connect-ExchangeOnline -Device
En PowerShell 7.0.3 o posterior mediante la versión 2.0.4 o posterior del módulo, este ejemplo se conecta a Exchange Online PowerShell en escenarios de scripting interactivos en equipos que no tienen exploradores web.
El comando devuelve una dirección URL y un código único vinculado a la sesión. Tendrá que abrir la dirección URL en un explorador de cualquier equipo y escribir el código único. Después de completar el inicio de sesión en el explorador web, la sesión de la ventana de Powershell 7 se autentica a través del flujo de autenticación Microsoft Entra normal y los cmdlets de Exchange Online se importan después de unos segundos.
Ejemplo 6
Connect-ExchangeOnline -InlineCredential
En PowerShell 7.0.3 o posterior mediante la versión 2.0.4 o posterior del módulo, este ejemplo se conecta a Exchange Online PowerShell en escenarios de scripting interactivos pasando credenciales directamente en la ventana de PowerShell.
Parámetros
-AccessToken
Nota: Este parámetro está disponible en la versión 3.1.0 o posterior del módulo.
El parámetro AccessToken especifica el token web JSON de OAuth (JWT) que se usa para conectarse a ExchangeOnline.
En función del tipo de token de acceso, debe usar este parámetro con el parámetro Organization, DelegatedOrganization o UserPrincipalName.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-AppId
El parámetro AppId especifica el identificador de aplicación de la entidad de servicio que se usa en la autenticación basada en certificados (CBA). Un valor válido es el GUID del identificador de aplicación (entidad de servicio). Por ejemplo, 36ee4c6c-0812-40a2-b820-b22ebd02bce3
.
Para obtener más información, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-AzureADAuthorizationEndpointUri
Nota: Si usa el parámetro ExchangeEnvironmentName, no es necesario usar los parámetros AzureADAuthorizationEndpointUri o ConnectionUri.
El parámetro AzureADAuthorizationEndpointUri especifica el punto de conexión de autorización de Microsoft Entra que puede emitir tokens de acceso de OAuth2. Se admiten los siguientes Exchange Online entornos de PowerShell y valores relacionados:
- Microsoft 365 o Microsoft 365 GCC: no use este parámetro. El valor necesario es
https://login.microsoftonline.com/common
, pero también es el valor predeterminado, por lo que no es necesario usar este parámetro. - Office 365 Alemania:
https://login.microsoftonline.de/common
- Microsoft 365 GCC High o Microsoft 365 DoD:
https://login.microsoftonline.us/common
Si usa el parámetro UserPrincipalName, no es necesario usar el parámetro AzureADAuthorizationEndpointUri para MFA o usuarios federados en entornos que lo requieran normalmente (se requiere UserPrincipalName o AzureADAuthorizationEndpointUri; Aceptar para usar ambos).
Nota: La autenticación MFA o la autenticación federada no están disponibles en Office 365 operados por 21Vianet.
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-BypassMailboxAnchoring
El modificador BypassMailboxAnchoring omite el uso de la sugerencia de anclaje del buzón. No es necesario especificar un valor con este modificador.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-Certificate
El parámetro Certificate especifica el certificado que se usa para la autenticación basada en certificados (CBA). Un valor válido es el valor del objeto X509Certificate2 del certificado.
No use este parámetro con los parámetros CertificateFilePath o CertificateThumbprint.
Para obtener más información sobre CBA, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Tipo: | X509Certificate2 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-CertificateFilePath
El parámetro CertificateFilePath especifica el certificado que se usa para CBA. Un valor válido es la ruta de acceso pública completa al archivo de certificado. Use el parámetro CertificatePassword con este parámetro.
No use este parámetro con los parámetros Certificate o CertificateThumbprint.
Para obtener más información sobre CBA, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-CertificatePassword
El parámetro CertificatePassword especifica la contraseña necesaria para abrir el archivo de certificado cuando se usa el parámetro CertificateFilePath para identificar el certificado que se usa para CBA.
Puede usar los métodos siguientes como valor para este parámetro:
-
(ConvertTo-SecureString -String '<password>' -AsPlainText -Force)
. - Antes de ejecutar este comando, almacene la contraseña como variable (por ejemplo, ) y, a continuación,
$password = Read-Host "Enter password" -AsSecureString
use la variable ($password
) para el valor. -
(Get-Credential).password
para que se le pida que escriba la contraseña de forma segura al ejecutar este comando.
Para obtener más información sobre CBA, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Nota: El uso de un comando ConvertTo-SecureString para almacenar la contraseña del certificado de forma local anula el propósito de un método de conexión seguro para escenarios de automatización. El uso de un comando Get-Credential para solicitar la contraseña del certificado de forma segura no es ideal para escenarios de automatización. En otras palabras, realmente no hay ninguna manera automatizada y segura de conectarse mediante un certificado local.
Tipo: | SecureString |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-CertificateThumbprint
El parámetro CertificateThumbprint especifica el certificado que se usa para CBA. Un valor válido es el valor de huella digital del certificado. Por ejemplo, 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1
.
No use este parámetro con los parámetros Certificate o CertificateFilePath.
Nota: El parámetro CertificateThumbprint solo se admite en Microsoft Windows.
Para obtener más información sobre CBA, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-CommandName
El parámetro CommandName especifica la lista separada por comas de los comandos que se van a importar en la sesión. Use este parámetro para las aplicaciones o scripts que usan un conjunto específico de cmdlets. Reducir el número de cmdlets de la sesión ayuda a mejorar el rendimiento y reduce la superficie de memoria de la aplicación o el script.
Tipo: | String[] |
Posición: | 6 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ConnectionUri
Nota: Si usa el parámetro ExchangeEnvironmentName, no es necesario usar los parámetros AzureADAuthorizationEndpointUri o ConnectionUri.
El parámetro ConnectionUri especifica el punto de conexión para la sesión de PowerShell. Se admiten los siguientes Exchange Online entornos de PowerShell y valores relacionados:
- Microsoft 365 o Microsoft 365 GCC: no use este parámetro. El valor necesario es
https://outlook.office365.com/powershell-liveid/
, pero también es el valor predeterminado, por lo que no es necesario usar este parámetro. - Office 365 Alemania:
https://outlook.office.de/PowerShell-LiveID
- Office 365 opera 21Vianet:
https://partner.outlook.cn/PowerShell
- Microsoft 365 GCC High:
https://outlook.office365.us/powershell-liveID
- DoD de Microsoft 365:
https://webmail.apps.mil/powershell-liveID
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-Credential
El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para conectarse a Exchange Online PowerShell. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios. No use este parámetro para las cuentas que usan la autenticación multifactor (MFA).
Antes de ejecutar el comando Connect-ExchangeOnline, almacene el nombre de usuario y la contraseña en una variable (por ejemplo, $UserCredential = Get-Credential
). A continuación, use el nombre de variable ($UserCredential
) para este parámetro.
Una vez completado el comando Connect-ExchangeOnline, se vacía la clave de contraseña de la variable.
Para especificar la contraseña de un archivo de certificado, no use este parámetro; use el parámetro CertificatePassword en su lugar.
Tipo: | PSCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-DelegatedOrganization
El parámetro DelegatedOrganization especifica la organización del cliente que desea administrar. Un valor válido para este parámetro es el dominio .onmicrosoft.com principal o el identificador de inquilino de la organización del cliente.
Este parámetro solo funciona si la organización del cliente ha aceptado la administración delegada a través del programa CSP.
Después de autenticarse correctamente, los cmdlets de esta sesión se asignan a la organización del cliente y todas las operaciones de esta sesión se realizan en la organización del cliente.
Tipo: | String |
Posición: | 4 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-Device
Nota: Este parámetro está disponible en la versión 2.0.4 o posterior del módulo y solo en PowerShell 7.
El conmutador Dispositivo se usa normalmente en equipos sin exploradores web. No es necesario especificar un valor con este modificador.
El uso de este modificador da como resultado un mensaje en pantalla que contiene la dirección URL https://microsoft.com/devicelogin y un código único. En cualquier otro dispositivo con un explorador web y acceso a Internet, abra la dirección URL, escriba el código único y escriba sus credenciales en las páginas posteriores.
Si el inicio de sesión se realizó correctamente, la conexión de PowerShell continúa.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-EnableErrorReporting
El modificador EnableErrorReporting especifica si se va a habilitar la generación de informes de errores. No es necesario especificar un valor con este modificador.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ExchangeEnvironmentName
ExchangeEnvironmentName especifica el entorno Exchange Online y elimina la necesidad de usar los parámetros AzureADAuthorizationEndpointUri y ConnectionUri. Se admiten los siguientes entornos de PowerShell Exchange Online:
- Microsoft 365 o Microsoft 365 GCC: no use este parámetro. El valor necesario es
O365Default
, pero también es el valor predeterminado, por lo que no es necesario usar este parámetro. - Office 365 Alemania:
O365GermanyCloud
- Office 365 opera 21Vianet:
O365China
- Microsoft 365 GCC High:
O365USGovGCCHigh
- DoD de Microsoft 365:
O365USGovDoD
Tipo: | ExchangeEnvironment |
Posición: | 2 |
Valor predeterminado: | O365Default |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-FormatTypeName
El parámetro FormatTypeName especifica el formato de salida del cmdlet.
Tipo: | String[] |
Posición: | 7 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-InlineCredential
Nota: Este parámetro está disponible en la versión 2.0.4 o posterior del módulo y solo en PowerShell 7.
El modificador InlineCredential especifica si se deben pasar las credenciales directamente en la ventana de Windows PowerShell. No es necesario especificar un valor con este modificador.
Este modificador es similar al parámetro Credential, pero con seguridad agregada. El modificador InlineCredential no requiere que almacene las credenciales localmente en el script y puede escribir las credenciales directamente en una sesión interactiva de PowerShell.
Este modificador no funciona con cuentas que usan MFA.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-LoadCmdletHelp
Nota: Este parámetro está disponible en la versión 3.7.0-Preview1 o posterior del módulo.
El modificador LoadCmdletHelp descarga los archivos de ayuda del cmdlet para el cmdlet Get-Help en las conexiones de la API REST. No es necesario especificar un valor con este modificador.
A partir de la versión 3.7.0-Preview1, los archivos de ayuda de la línea de comandos no se descargan de forma predeterminada. Use este modificador para descargar los archivos de ayuda del cmdlet en la línea de comandos.
Sugerencia: Este parámetro reemplaza al parámetro SkipLoadingCmdletHelp. El parámetro SkipLoadingCmdletHelp ya no es necesario y ya no funciona, ya que los archivos de ayuda del cmdlet ya no se descargan de forma predeterminada.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-LogDirectoryPath
El parámetro LogDirectoryPath especifica la ubicación de los archivos de registro. La ubicación predeterminada es %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv
.
Si especifica una ubicación personalizada y un nombre de archivo que contenga espacios, incluya el valor entre comillas (").
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-LogLevel
El parámetro LogLevel especifica el nivel de registro. Los valores válidos son Default y All.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ManagedIdentity
El modificador ManagedIdentity especifica que usa la identidad administrada para conectarse. No es necesario especificar un valor con este modificador.
Actualmente, las conexiones de identidad administrada se admiten para los siguientes tipos de recursos de Azure:
- runbooks de Azure Automation
- Máquinas virtuales de Azure
- Azure Virtual Machine Scale Sets
- Azure Functions
Debe usar este modificador con el parámetro Organization.
Para la identidad administrada asignada por el usuario, también debe usar este modificador con el parámetro ManagedIdentityAccountId.
Para obtener más información sobre cómo conectarse con una identidad administrada, consulte Uso de identidades administradas de Azure para conectarse a Exchange Online PowerShell.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ManagedIdentityAccountId
El parámetro ManagedIdentityAccountId especifica la identidad administrada asignada por el usuario que se usa para conectarse. Un valor válido para este parámetro es el identificador de aplicación (GUID) de la entidad de servicio que corresponde a la identidad administrada asignada por el usuario en Azure.
Debe usar este parámetro con el parámetro Organization y el modificador ManagedIdentity.
Para obtener más información sobre cómo conectarse con una identidad administrada, consulte Uso de identidades administradas de Azure para conectarse a Exchange Online PowerShell.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-Organization
El parámetro Organization especifica la organización al conectarse mediante CBA o identidad administrada. Un valor válido para este parámetro es el dominio .onmicrosoft.com principal o el identificador de inquilino de la organización.
Para obtener más información sobre cómo conectarse con CBA, consulte Autenticación de solo aplicación para scripts desatendidos en el módulo de PowerShell Exchange Online.
Para obtener más información sobre cómo conectarse con una identidad administrada, consulte Uso de identidades administradas de Azure para conectarse a Exchange Online PowerShell.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-PageSize
El parámetro PageSize especifica el número máximo de entradas por página. La entrada válida para este parámetro es un número entero entre 1 y 1000. El valor predeterminado es 1000.
Tipo: | UInt32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-Prefix
El parámetro Prefix especifica un valor de texto que se va a agregar a los nombres de Exchange Online cmdlets de PowerShell al conectarse. Por ejemplo, Get-InboundConnector se convierte en Get-ContosoInboundConnector cuando se usa el valor Contoso para este parámetro.
- El valor Prefix no puede contener espacios ni caracteres especiales, como caracteres de subrayado o asteriscos.
- No se puede usar el valor prefijo EXO. Ese valor está reservado para los nueve cmdlets get-EXO* exclusivos integrados en el módulo.
- El parámetro Prefix solo afecta a los nombres de cmdlet Exchange Online importados. No afecta a los nombres de los cmdlets integrados en el módulo (por ejemplo, Disconnect-ExchangeOnline).
Tipo: | String |
Posición: | 5 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-PSSessionOption
Nota: Este parámetro no funciona en las conexiones de API REST.
El parámetro PSSessionOption especifica las opciones de sesión de PowerShell que se usarán en la conexión a Exchange Online. Este parámetro solo funciona si también usa el modificador UseRPSSession en el mismo comando.
Almacene la salida del comando New-PSSessionOption en una variable (por ejemplo, $PSOptions = New-PSSessionOption <Settings>
) y use el nombre de la variable como valor para este parámetro (por ejemplo, $PSOptions
).
Tipo: | PSSessionOption |
Posición: | 3 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ShowBanner
El modificador ShowBanner muestra u oculta el mensaje de banner que se muestra al ejecutar Connect-ExchangeOnline. No es necesario especificar un valor con este modificador.
- Para mostrar el banner, no es necesario usar este modificador (el banner se muestra de forma predeterminada).
- Para ocultar el banner, use esta sintaxis exacta:
-ShowBanner:$false
.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | $true |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-ShowProgress
El parámetro ShowProgress especifica si se debe mostrar u ocultar la barra de progreso de los cmdlets importados al conectarse. Los valores admitidos son:
- $true: se muestra la barra de progreso. Este es el valor predeterminado.
- $false: actualmente, este valor no tiene ningún efecto.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-SigningCertificate
Nota: Este parámetro está disponible en la versión 3.2.0 o posterior del módulo.
El parámetro SigningCertificate especifica el certificado de cliente que se usa para firmar los archivos de formato (*. Format.ps1xml) o archivos de módulo de script (.psm1) en el módulo temporal que Connect-ExchangeOnline crea.
Un valor válido para este parámetro es una variable que contiene el certificado, o un comando o expresión que obtiene el certificado.
Para buscar el certificado, use el cmdlet Get-PfxCertificate en el módulo Microsoft.PowerShell.Security o use el cmdlet Get-ChildItem en la unidad de certificado (Cert:). Si el certificado no es válido o no tiene suficiente autoridad, se producirá un error en el comando.
Tipo: | X509Certificate2 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-SkipLoadingCmdletHelp
Nota: Este parámetro está disponible en la versión 3.3.0 o posterior del módulo.
En la versión 3.7.0-Preview1 o posterior, este parámetro se reemplaza por el parámetro LoadCmdletHelp. El parámetro SkipLoadingCmdletHelp ya no es necesario y ya no hace nada, ya que los archivos de ayuda del cmdlet ya no se descargan de forma predeterminada. Finalmente, este parámetro se retirará, por lo que se quitará de los scripts.
El modificador SkipLoadingCmdletHelp impide descargar los archivos de ayuda del cmdlet para el cmdlet Get-Help en las conexiones de la API REST. No es necesario especificar un valor con este modificador.
Cuando se usa este modificador, no se obtienen archivos de ayuda locales para ningún cmdlet en la línea de comandos.
Este modificador no funciona con el modificador UseRPSSession.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-SkipLoadingFormatData
El modificador SkipLoadingFormatData impide descargar los datos de formato para las conexiones de API REST. No es necesario especificar un valor con este modificador.
Cuando se usa este modificador, la salida de cualquier cmdlet de Exchange no tendrá formato.
Use este modificador para evitar errores al conectarse a Exchange Online PowerShell desde un servicio windows o el SDK de Windows PowerShell.
Este modificador no funciona con el modificador UseRPSSession.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-TrackPerformance
El parámetro TrackPerformance mide eventos adicionales (por ejemplo, carga de CPU y memoria consumida). Los valores admitidos son:
- $true: el seguimiento del rendimiento está habilitado.
- $false: el seguimiento del rendimiento está deshabilitado. Este es el valor predeterminado.
Este parámetro solo funciona cuando el registro está habilitado.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-UseMultithreading
El parámetro UseMultithreading especifica si se va a deshabilitar o habilitar el multiproceso en el módulo de PowerShell Exchange Online. Los valores admitidos son:
- $true: Habilitar el multiproceso. Este es el valor predeterminado.
- $false: deshabilite el multiproceso. Este valor degradará el rendimiento de los nueve cmdlets Get-EXO* exclusivos del módulo.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-UserPrincipalName
El parámetro UserPrincipalName especifica la cuenta que desea usar para conectarse (por ejemplo, navin@contoso.onmicrosoft.com
). El uso de este parámetro le permite omitir la entrada de un nombre de usuario en el símbolo del sistema de credenciales de autenticación moderna (se le pedirá que escriba una contraseña).
Si usa el parámetro UserPrincipalName, no es necesario usar el parámetro AzureADAuthorizationEndpointUri para MFA o usuarios federados en entornos que lo requieran normalmente (se requiere UserPrincipalName o AzureADAuthorizationEndpointUri; Aceptar para usar ambos).
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |
-UseRPSSession
Nota: Las conexiones remotas de PowerShell a Exchange Online PowerShell están en desuso. Para obtener más información, vea Desuso de PowerShell remoto en Exchange Online.
El modificador UseRPSSession permite conectarse a Exchange Online PowerShell mediante el acceso remoto tradicional de PowerShell a todos los cmdlets. No es necesario especificar un valor con este modificador.
Este modificador requiere que la autenticación básica esté habilitada en WinRM en el equipo local. Para obtener más información, vea Activar la autenticación básica en WinRM.
Si no usa este modificador, se usa el modo de API REST para la conexión, por lo que no se requiere la autenticación básica en WinRM.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online |