Compartir a través de

Get-ConnectionInformation

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en la versión 3.0.0 o posterior del 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 Get-ConnectionInformation para obtener información sobre todas las conexiones basadas en REST en la instancia actual de PowerShell 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 (Es el 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 actual de PowerShell. Este cmdlet es equivalente al cmdlet Get-PSSession que se usa con sesiones remotas de PowerShell.

La salida del cmdlet contiene las siguientes propiedades:

  • ConnectionId: valor de GUID único para la conexión. Por ejemplo, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Estado: por ejemplo, Conectado.
  • Id: 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 id. Por ejemplo, ExchangeOnline_1 para Exchange Online PowerShell o ExchangeOnlineProtection_1 para PowerShell de cumplimiento de seguridad &.
  • 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 cumplimiento de seguridad &.
  • AzureAdAuthorizationEndpointUri: el punto de conexión de autorización 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 cumplimiento de seguridad &.
  • TokenExpiryTimeUTC: cuando expira el token de conexión. Por ejemplo, 9/30/2023 6:42:24 PM +00:00.
  • CertificateAuthentication: si se usó la autenticación basada en certificados (también conocida como CBA o autenticación solo de aplicación) para conectarse. 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: valor especificado mediante el parámetro Prefix en el comando Connect-ExchangeOnline o Connect-IPPSSession.
  • Organización: valor especificado mediante el parámetro Organization en el comando Connect-ExchangeOnline o Connect-IPPSSession para las conexiones de identidad administrada o CBA.
  • DelegatedOrganization: valor especificado mediante el parámetro DelegatedOrganization en el comando Connect-ExchangeOnline o Connect-IPPSSession.
  • AppId: valor especificado mediante el parámetro AppId en el comando Connect-ExchangeOnline o Connect-IPPSSession para las conexiones CBA.
  • PageSize: 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: valor del GUID del identificador de inquilino. Por ejemplo, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: por ejemplo, Activo.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: para Exchange Online conexiones de PowerShell, el valor es False. En el caso de las conexiones de PowerShell de cumplimiento de seguridad &, 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 actual de PowerShell.

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 3.2.0-Preview2 del módulo 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 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 filtra las conexiones por 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.

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 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

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.