Get-ConnectionInformation

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul, Version 3.0.0 oder höher, verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.

Verwenden Sie das Get-ConnectionInformation Cmdlet, um Informationen zu allen REST-basierten Verbindungen in der aktuellen PowerShell-instance mit Exchange Online zu erhalten.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Default (Standard) 

Get-ConnectionInformation
    [<CommonParameters>]

ConnectionId 

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

ModulePrefix 

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

Beschreibung

Das Get-ConnectionInformation Cmdlet gibt die Informationen zu allen aktiven REST-basierten Verbindungen mit Exchange Online im aktuellen PowerShell-instance zurück. Dieses Cmdlet entspricht dem Get-PSSession Cmdlet, das bei Remote-PowerShell-Sitzungen verwendet wird.

Die Ausgabe des Cmdlets enthält die folgenden Eigenschaften:

  • ConnectionId: Ein eindeutiger GUID-Wert für die Verbindung. Beispiel: 8b632b3a-a2e2-8ff3-adcd-6d119d07694b.
  • Status: z. B. Verbunden.
  • ID: Eine ganze Zahl, die die Sitzung im PowerShell-Fenster identifiziert. Die erste Verbindung ist 1, die zweite ist 2 usw.
  • Name: Ein eindeutiger Name, der auf der PowerShell-Umgebung und dem ID-Wert basiert. Beispielsweise ExchangeOnline_1 für Exchange Online PowerShell oder ExchangeOnlineProtection_1 für Security & Compliance PowerShell.
  • UserPrincipalName: Das Konto, das zum Herstellen der Verbindung verwendet wurde. Beispiel: laura@contoso.onmicrosoft.com.
  • ConnectionUri: Der verwendete Verbindungsendpunkt. Beispielsweise https://outlook.office365.com für Exchange Online PowerShell oder https://nam12b.ps.compliance.protection.outlook.com für Security & Compliance PowerShell.
  • AzureAdAuthorizationEndpointUri : Der Microsoft Entra-Autorisierungsendpunkt für die Verbindung. Beispielsweise https://login.microsoftonline.com/organizations für Exchange Online PowerShell oder https://login.microsoftonline.com/organizations für Security & Compliance PowerShell.
  • TokenExpiryTimeUTC: Wenn das Verbindungstoken abläuft. Beispiel: 30.09.2023 18:42:24 +00:00.
  • CertificateAuthentication: Gibt an, ob die zertifikatbasierte Authentifizierung (auch als CBA oder Nur-App-Authentifizierung bezeichnet) zum Herstellen einer Verbindung verwendet wurde. Gültige Werte sind "True" oder "False".
  • ModuleName: Der Dateiname und Pfad der temporären Daten für die Sitzung. Beispiel: C:\Users\laura\AppData\Local\Temp\tmpEXO_a54z135k.qgv
  • ModulePrefix: Der Wert, der mit dem Prefix-Parameter im Connect-ExchangeOnline- oder Connect-IPPSSession-Befehl angegeben wurde.
  • Organisation: Der Wert, der mit dem Parameter "Organisation" im Befehl "Connect-ExchangeOnline" oder "Connect-IPPSSession" für CBA- oder Verbindungen mit verwalteten Identitäten angegeben wird.
  • DelegatedOrganization: Der Wert, der mit dem Parameter DelegatedOrganization im Befehl Connect-ExchangeOnline oder Connect-IPPSSession angegeben wird.
  • AppId: Der Wert, der mit dem AppId-Parameter im Befehl Connect-ExchangeOnline oder Connect-IPPSSession für CBA-Verbindungen angegeben wird.
  • PageSize: Die standardmäßige maximale Anzahl von Einträgen pro Seite in der Verbindung. Der Standardwert ist 1000, oder Sie können den Parameter PageSize im Befehl Connect-ExchangeOnline verwenden, um einen niedrigeren Wert anzugeben. Einzelne Cmdlets verfügen möglicherweise auch über einen PageSize-Parameter.
  • TenantID: Der GUID-Wert der Mandanten-ID. Beispiel: 3750b40b-a68b-4632-9fb3-5b1aff664079.
  • TokenStatus: Zum Beispiel "Aktiv".
  • ConnectionUsedForInbuiltCmdlets
  • IsEopSession: Für Exchange Online PowerShell-Verbindungen ist der Wert False. Für PowerShell-Verbindungen mit Security & Compliance lautet der Wert "True".

Beispiele

Beispiel 1

Get-ConnectionInformation

Dieses Beispiel gibt eine Liste aller aktiven REST-basierten Verbindungen mit Exchange Online in der aktuellen PowerShell-Instance zurück.

Beispiel 2

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

Dieses Beispiel gibt die aktive REST-basierte Verbindung mit dem angegebenen ConnectionId-Wert zurück.

Beispiel 3

Get-ConnectionInformation -ModulePrefix Contoso,Fabrikam

Dieses Beispiel gibt eine Liste aktiver REST-basierter Verbindungen zurück, die die angegebenen Präfixwerte verwenden.

Parameter

-ConnectionId

Anwendbar: Exchange Online

Hinweis: Dieser Parameter ist in Modulversion 3.2.0-Preview2 oder höher verfügbar.

Der Parameter ConnectionId filtert die Verbindungen nach ConnectionId. ConnectionId ist ein GUID-Wert in der Ausgabe des Get-ConnectionInformation-Cmdlets, der eine Verbindung eindeutig identifiziert, auch wenn mehrere Verbindungen geöffnet sind. Sie können mehrere ConnectionId-Werte angeben, die durch Kommas getrennt sind.

Verwenden Sie diesen Parameter nicht mit dem Parameter ModulePrefix.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ConnectionId
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ModulePrefix

Anwendbar: Exchange Online

Hinweis: Dieser Parameter ist in Modulversion 3.2.0-Preview2 oder höher verfügbar.

Der Parameter ModulePrefix filtert die Verbindungen nach ModulePrefix. Wenn Sie den Prefix-Parameter mit dem Connect-ExchangeOnline Cmdlet verwenden, wird der angegebene Text zu den Namen aller Exchange Online Cmdlets hinzugefügt (beispielsweise wird Get-InboundConnector zu Get-ContosoInboundConnector). Der ModulePrefix-Wert ist in der Ausgabe des Get-ConnectionInformation Cmdlets sichtbar. Sie können mehrere ModulePrefix-Werte angeben, die durch Kommas getrennt sind.

Dieser Parameter ist nur für Verbindungen von Bedeutung, die mit dem Prefix-Parameter erstellt wurden.

Verwenden Sie diesen Parameter nicht mit dem Parameter ConnectionId.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ModulePrefix
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.