Connect-IPPSSession

Der Parameter AppId gibt die Anwendungs-ID des Dienstprinzipals an, der in der zertifikatbasierten Authentifizierung (Certificate Based Authentication, CBA) verwendet wird. Ein gültiger Wert ist die GUID der Anwendungs-ID (Dienstprinzipal). Beispiel: 36ee4c6c-0812-40a2-b820-b22ebd02bce3.

Weitere Informationen finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Der Parameter AzureADAuthorizationEndpointUri gibt den Azure AD-Autorisierungsendpunkt an, der OAuth2-Zugriffstoken ausstellen kann. Die folgenden PowerShell-Umgebungen und zugehörige Werte werden unterstützt:

• Security & Compliance PowerShell in Microsoft 365 oder Microsoft 365 GCC: Verwenden Sie diesen Parameter nicht. Der erforderliche Wert ist https://login.microsoftonline.com/common, aber dies ist auch der Standardwert, sodass Sie diesen Parameter nicht verwenden müssen.
• Security & Compliance PowerShell in Office 365 betrieben von 21Vianet:https://login.chinacloudapi.cn/common
• Security & Compliance PowerShell in Microsoft GCC High oder Microsoft DoD: https://login.microsoftonline.us/common

Wenn Sie den UserPrincipalName-Parameter verwenden, müssen Sie den Parameter AzureADAuthorizationEndpointUri nicht für MFA oder Verbundbenutzer in Umgebungen verwenden, die ihn normalerweise erfordern (UserPrincipalName oder AzureADAuthorizationEndpointUri ist erforderlich; OK, um beides zu verwenden).

Der BypassMailboxAnchoring-Schalter umgeht die Verwendung des Postfachankerhinweises. Sie müssen bei dieser Option keinen Wert angeben.

Der Parameter Certificate gibt das Zertifikat an, das für die zertifikatbasierte Authentifizierung (Certificate-Based Authentication, CBA) verwendet wird. Ein gültiger Wert ist der X509Certificate2-Objektwert des Zertifikats.

Verwenden Sie diesen Parameter nicht mit den Parametern CertificateFilePath oder CertificateThumbprint.

Weitere Informationen zur CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Der Parameter CertificateFilePath gibt das Zertifikat an, das für die CBA verwendet wird. Ein gültiger Wert ist der vollständige öffentliche Pfad zur Zertifikatdatei. Verwenden Sie den Parameter CertificatePassword mit diesem Parameter.

Verwenden Sie diesen Parameter nicht mit den Parametern Certificate oder CertificateThumbprint.

Weitere Informationen zur CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Der Parameter CertificatePassword gibt das Kennwort an, das zum Öffnen der Zertifikatdatei erforderlich ist, wenn Sie den Parameter CertificateFilePath verwenden, um das Zertifikat zu identifizieren, das für die CBA verwendet wird.

Sie können die folgenden Methoden als Wert für diesen Parameter verwenden:

• (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
• Bevor Sie diesen Befehl ausführen, speichern Sie das Kennwort als Variable (z. B $password = Read-Host "Enter password" -AsSecureString. ), und verwenden Sie dann die Variable ($password) für den Wert.
• (Get-Credential).password aufgefordert werden, das Kennwort sicher einzugeben, wenn Sie diesen Befehl ausführen.

Weitere Informationen zur CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Hinweis: Die Verwendung eines ConvertTo-SecureString-Befehls zum lokalen Speichern des Kennworts des Zertifikats verfehlt den Zweck einer sicheren Verbindungsmethode für Automatisierungsszenarien. Die Verwendung eines Get-Credential-Befehls , um Sie zur sicheren Eingabe des Kennworts des Zertifikats aufzufordern, ist für Automatisierungsszenarien nicht ideal. Anders ausgedrückt: Es gibt wirklich keine automatisierte und sichere Möglichkeit, eine Verbindung mithilfe eines lokalen Zertifikats herzustellen.

Der Parameter CertificateThumbprint gibt das Zertifikat an, das für die CBA verwendet wird. Ein gültiger Wert ist der Fingerabdruckwert des Zertifikats. Beispiel: 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.

Verwenden Sie diesen Parameter nicht mit den Parametern Certificate oder CertificateFilePath.

Hinweis: Der Parameter CertificateThumbprint wird nur in Microsoft Windows unterstützt.

Weitere Informationen zur CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Der CommandName-Parameter gibt die durch Trennzeichen getrennte Liste von Befehlen an, die in die Sitzung importiert werden sollen. Verwenden Sie diesen Parameter für Anwendungen oder Skripts, die einen bestimmten Satz von Cmdlets verwenden. Das Reduzieren der Anzahl von Cmdlets in der Sitzung trägt zur Verbesserung der Leistung bei und reduziert den Speicherbedarf der Anwendung oder des Skripts.

Der ConnectionUri-Parameter gibt den Verbindungsendpunkt für die PowerShell-Remotesitzung an. Die folgenden PowerShell-Umgebungen und zugehörige Werte werden unterstützt:

• Security & Compliance PowerShell in Microsoft 365 oder Microsoft 365 GCC: Verwenden Sie diesen Parameter nicht. Der erforderliche Wert ist https://ps.compliance.protection.outlook.com/powershell-liveid/, aber dies ist auch der Standardwert, sodass Sie diesen Parameter nicht verwenden müssen.
• Security & Compliance PowerShell in Office 365 betrieben von 21Vianet:https://ps.compliance.protection.partner.outlook.cn/powershell-liveid
• PowerShell zur Sicherheitskonformität & in Microsoft GCC High: https://ps.compliance.protection.office365.us/powershell-liveid/
• PowerShell zur Sicherheitskonformität & in Microsoft DoD: https://l5.ps.compliance.protection.office365.us/powershell-liveid/

Der Parameter Credential gibt den Benutzernamen und das Kennwort an, die zum Herstellen einer Verbindung mit Exchange Online PowerShell verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen. Verwenden Sie diesen Parameter nicht für Konten, die die mehrstufige Authentifizierung (Multi-Factor Authentication, MFA) verwenden.

Bevor Sie den Befehl Connect-IPPSSession ausführen, speichern Sie den Benutzernamen und das Kennwort in einer Variablen (z. B $UserCredential = Get-Credential. ). Verwenden Sie dann den Variablennamen ($UserCredential) für diesen Parameter.

Nach Abschluss des Connect-IPPSSession Befehls wird der Kennwortschlüssel in der Variablen geleert.

Der Parameter DelegatedOrganization gibt die kundenseitig organization an, die Sie verwalten möchten (z. B. contosoelectronics.onmicrosoft.com). Dieser Parameter funktioniert nur, wenn der Kunde organization Ihrer delegierten Verwaltung über das CSP-Programm zugestimmt hat.

Nach der erfolgreichen Authentifizierung werden die Cmdlets in dieser Sitzung dem kundenbasierten organization zugeordnet, und alle Vorgänge in dieser Sitzung werden für den Kunden organization ausgeführt.

Hinweise:

• Verwenden Sie die primäre .onmicrosoft.com-Domäne des delegierten organization für den Wert dieses Parameters.
• Sie müssen den Parameter AzureADAuthorizationEndpointUri mit diesem Parameter verwenden.

Der Parameter FormatTypeName gibt das Ausgabeformat des Cmdlets an.

Der Parameter Organization gibt die organization an, wenn Sie eine Verbindung mit CBA herstellen. Sie müssen die primäre .onmicrosoft.com-Domäne des organization für den Wert dieses Parameters verwenden.

Weitere Informationen zur CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.

Der Parameter Prefix gibt einen Textwert an, der den Namen von PowerShell-Cmdlets zur Sicherheitskonformität & hinzugefügt werden soll, wenn Sie eine Verbindung herstellen. Beispielsweise wird Get-ComplianceCase Get-ContosoComplianceCase, wenn Sie den Wert Contoso für diesen Parameter verwenden.

• Der Präfixwert darf keine Leerzeichen oder Sonderzeichen wie Unterstriche oder Sternchen enthalten.
• Sie können den Präfixwert EXO nicht verwenden. Dieser Wert ist für die neun exklusiven Get-EXO*- Cmdlets reserviert, die in das Modul integriert sind.
• Der Parameter Prefix wirkt sich nur auf importierte Cmdlet-Namen für die Sicherheitskonformität & aus. Dies wirkt sich nicht auf die Namen von Cmdlets aus, die in das Modul integriert sind (z. B. Disconnect-ExchangeOnline).

Der PSSessionOption-Parameter gibt die PowerShell-Remotesitzungsoptionen an, die in Ihrer Verbindung mit Security & Compliance PowerShell verwendet werden sollen.

Speichern Sie die Ausgabe des Befehls New-PSSessionOption in einer Variablen (z. B $PSOptions = New-PSSessionOption <Settings>. ), und verwenden Sie den Variablennamen als Wert für diesen Parameter (z. B $PSOptions. ).

Der Parameter UserPrincipalName gibt das Konto an, navin@contoso.onmicrosoft.comdas Sie zum Herstellen einer Verbindung verwenden möchten (z. B. ). Mit diesem Parameter können Sie die Eingabe eines Benutzernamens in der Modernen Anmeldeinformationen für die Authentifizierung überspringen (Sie werden zur Eingabe eines Kennworts aufgefordert).

Wenn Sie den UserPrincipalName-Parameter verwenden, müssen Sie den Parameter AzureADAuthorizationEndpointUri nicht für MFA oder Verbundbenutzer in Umgebungen verwenden, die ihn normalerweise erfordern (UserPrincipalName oder AzureADAuthorizationEndpointUri ist erforderlich; OK, um beides zu verwenden).

Dieser Parameter ist in Version 3.2.0 oder höher des Moduls verfügbar.

Mit dem UseRPSSession-Schalter können Sie mithilfe des herkömmlichen Remotezugriffs von PowerShell auf alle Cmdlets eine Verbindung mit Security & Compliance PowerShell herstellen. Sie müssen keinen Wert für diese Option angeben.

Dieser Switch erfordert, dass die Standardauthentifizierung in WinRM auf dem lokalen Computer aktiviert ist. Weitere Informationen finden Sie unter Aktivieren der Standardauthentifizierung in WinRM.

Wenn Sie diesen Schalter nicht verwenden, ist die Standardauthentifizierung in WinRM nicht erforderlich.