Get-ConnectionInformation

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el módulo de PowerShell de Exchange Online versión 3.0.0 o posterior. Para obtener más información, consulte Acerca del módulo de PowerShell de Exchange Online.

Use el cmdlet Get-ConnectionInformation para obtener información sobre todas las conexiones basadas en REST en la instancia de PowerShell actual con Exchange Online.

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

Default (valor predeterminado) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

Get-ConnectionInformation
    -ConnectionId <String[]>
    [<CommonParameters>]

ModulePrefix 

Get-ConnectionInformation
    -ModulePrefix <String[]>
    [<CommonParameters>]

Description

El cmdlet Get-ConnectionInformation devuelve la información sobre todas las conexiones activas basadas en REST con Exchange Online en la instancia de PowerShell actual. Este cmdlet equivale al cmdlet de Get-PSSession que se usa con las sesiones remotas de PowerShell.

El resultado del cmdlet contiene las siguientes propiedades:

  • ConnectionId: un valor GUID único para la conexión. Por ejemplo, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Estado: Por ejemplo, conectado.
  • Id.: un entero que identifica la sesión en la ventana de PowerShell. La primera conexión es 1, la segunda es 2, etc.
  • Nombre: un nombre único que se basa en el entorno de PowerShell y el valor de identificador. Por ejemplo, ExchangeOnline_1 para Exchange Online PowerShell o ExchangeOnlineProtection_1 para PowerShell de seguridad & cumplimiento.
  • UserPrincipalName: la cuenta que se usó para conectarse. Por ejemplo, laura@contoso.onmicrosoft.com.
  • ConnectionUri: el punto de conexión que se usó. Por ejemplo, https://outlook.office365.com para Exchange Online PowerShell o https://nam12b.ps.compliance.protection.outlook.com para PowerShell de seguridad & cumplimiento.
  • AzureAdAuthorizationEndpointUri : punto de conexión de autorización de Microsoft Entra para la conexión. Por ejemplo, https://login.microsoftonline.com/organizations para Exchange Online PowerShell o https://login.microsoftonline.com/organizations para PowerShell de seguridad & cumplimiento.
  • TokenExpiryTimeUTC: cuando expira el token de conexión. Por ejemplo, 30/9/2023 6:42:24 p. m. +00:00.
  • CertificateAuthentication: si se usó para conectarse la autenticación basada en un certificado (también conocida como autenticación CBA o de solo aplicación). Los valores son True o False.
  • ModuleName: nombre de archivo y ruta de acceso de los datos temporales de la sesión. Por ejemplo, C:\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix: El valor especificado mediante el parámetro Prefix en el comando Connect-ExchangeOnline o Connect-IPPSSession.
  • Organización: el valor especificado mediante el parámetro Organization en el comando Connect-ExchangeOnline o Connect-IPPSSession para conexiones CBA o de identidad administrada.
  • DelegatedOrganization: el valor especificado mediante el parámetro DelegatedOrganization en el comando Connect-ExchangeOnline o Connect-IPPSSession.
  • AppId: el valor especificado mediante el parámetro AppId en el comando Connect-ExchangeOnline o Connect-IPPSSession para conexiones CBA.
  • PageSize: El número máximo predeterminado de entradas por página en la conexión. El valor predeterminado es 1000, o puede usar el parámetro PageSize en el comando Connect-ExchangeOnline para especificar un número inferior. Los cmdlets individuales también pueden tener un parámetro PageSize.
  • TenantID: el valor GUID del id. de inquilino. Por ejemplo, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: por ejemplo, Activo.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: Para las conexiones de PowerShell de Exchange Online, el valor es Falso. Para las conexiones de PowerShell de seguridad & cumplimiento, el valor es True.

Ejemplos

Ejemplo 1

Get-ConnectionInformation

En este ejemplo se devuelve una lista de todas las conexiones activas basadas en REST con Exchange Online en la instancia de PowerShell actual.

Ejemplo 2

Get-ConnectionInformation -ConnectionId 1a9e45e8-e7ec-498f-9ac3-0504e987fa85

En este ejemplo se devuelve la conexión basada en REST activa con el valor ConnectionId especificado.

Ejemplo 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

En este ejemplo se devuelve una lista de conexiones activas basadas en REST que usan los valores de prefijo especificados.

Parámetros

-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 filtra las conexiones por 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:False
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 filtra las conexiones por 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.

Este parámetro solo es significativo para las conexiones que se crearon con el parámetro Prefix.

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

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.