Partager via

Get-ConnectionInformation

Module:
Exchange PowerShell

Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online version 3.0.0 ou ultérieure. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.

Utilisez l’applet de commande Get-ConnectionInformation pour obtenir des informations sur toutes les connexions REST dans le instance PowerShell actuel avec Exchange Online.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default (Par défaut) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

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

ModulePrefix 

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

Description

L’applet de commande Get-ConnectionInformation retourne les informations sur toutes les connexions REST actives avec Exchange Online dans le instance PowerShell actuel. Cette applet de commande équivaut à l’applet de commande Get-PSSession utilisée avec les sessions PowerShell distantes.

La sortie de l’applet de commande contient les propriétés suivantes :

  • ConnectionId : valeur GUID unique pour la connexion. Par exemple, 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • État : par exemple, Connecté.
  • Id : entier qui identifie la session dans la fenêtre PowerShell. La première connexion est 1, la seconde est 2, etc.
  • Nom : nom unique basé sur l’environnement PowerShell et la valeur d’ID. Par exemple, ExchangeOnline_1 pour Exchange Online PowerShell ou ExchangeOnlineProtection_1 pour PowerShell sécurité & Conformité.
  • UserPrincipalName : compte utilisé pour se connecter. Par exemple : laura@contoso.onmicrosoft.com.
  • ConnectionUri : point de terminaison de connexion utilisé. Par exemple, https://outlook.office365.com pour Exchange Online PowerShell ou https://nam12b.ps.compliance.protection.outlook.com pour La sécurité & Conformité PowerShell.
  • AzureAdAuthorizationEndpointUri : point de terminaison d’autorisation Microsoft Entra pour la connexion. Par exemple, https://login.microsoftonline.com/organizations pour Exchange Online PowerShell ou https://login.microsoftonline.com/organizations pour La sécurité & Conformité PowerShell.
  • TokenExpiryTimeUTC : lorsque le jeton de connexion expire. Par exemple, 30/09/2023 6:42:24 PM +00:00.
  • CertificateAuthentication : indique si l’authentification basée sur les certificats (également appelée authentification CBA ou application uniquement) a été utilisée pour la connexion. Les valeurs sont True ou False.
  • ModuleName : nom de fichier et chemin des données temporaires de la session. Par exemple, C :\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix : valeur spécifiée à l’aide du paramètre Prefix dans la commande Connect-ExchangeOnline ou Connect-IPPSSession.
  • Organisation : valeur spécifiée à l’aide du paramètre Organization dans la commande Connect-ExchangeOnline ou Connect-IPPSSession pour les connexions DBA ou d’identité managée.
  • DelegatedOrganization : valeur spécifiée à l’aide du paramètre DelegatedOrganization dans la commande Connect-ExchangeOnline ou Connect-IPPSSession.
  • AppId : valeur spécifiée à l’aide du paramètre AppId dans la commande Connect-ExchangeOnline ou Connect-IPPSSession pour les connexions DBA.
  • PageSize : nombre maximal d’entrées par page par défaut dans la connexion. La valeur par défaut est 1000, ou vous pouvez utiliser le paramètre PageSize dans la commande Connect-ExchangeOnline pour spécifier un nombre inférieur. Les applets de commande individuelles peuvent également avoir un paramètre PageSize.
  • TenantID : valeur GUID de l’ID de locataire. Par exemple, 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus : par exemple, Active.
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession : pour Exchange Online connexions PowerShell, la valeur est False. Pour les connexions PowerShell sécurité & conformité, la valeur est True.

Exemples

Exemple 1

Get-ConnectionInformation

Cet exemple retourne une liste de toutes les connexions REST actives avec Exchange Online dans le instance PowerShell actuel.

Exemple 2

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

Cet exemple retourne la connexion REST active avec la valeur ConnectionId spécifiée.

Exemple 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

Cet exemple retourne une liste de connexions REST actives qui utilisent les valeurs de préfixe spécifiées.

Paramètres

-ConnectionId

Applicable : Exchange Online

Remarque : Ce paramètre est disponible dans le module version 3.2.0-Preview2 ou ultérieure.

Le paramètre ConnectionId filtre les connexions par ConnectionId. ConnectionId est une valeur GUID dans la sortie de l’applet de commande Get-ConnectionInformation qui identifie de façon unique une connexion, même si plusieurs connexions sont ouvertes. Vous pouvez spécifier plusieurs valeurs ConnectionId séparées par des virgules.

N’utilisez pas ce paramètre avec le paramètre ModulePrefix.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ConnectionId
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ModulePrefix

Applicable : Exchange Online

Remarque : Ce paramètre est disponible dans le module version 3.2.0-Preview2 ou ultérieure.

Le paramètre ModulePrefix filtre les connexions par ModulePrefix. Lorsque vous utilisez le paramètre Prefix avec l’applet de commande Connect-ExchangeOnline, le texte spécifié est ajouté aux noms de toutes les applets de commande Exchange Online (par exemple, Get-InboundConnector devient Get-ContosoInboundConnector). La valeur ModulePrefix est visible dans la sortie de l’applet de commande Get-ConnectionInformation. Vous pouvez spécifier plusieurs valeurs ModulePrefix séparées par des virgules.

Ce paramètre est significatif uniquement pour les connexions créées avec le paramètre Prefix.

N’utilisez pas ce paramètre avec le paramètre ConnectionId.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ModulePrefix
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.