Connect-IPPSSession
Dieses Cmdlet ist nur im PowerShell-Modul Exchange Online verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.
Verwenden Sie das Connect-IPPSSession Cmdlet im Exchange Online PowerShell-Modul, um mithilfe moderner Authentifizierung eine Verbindung mit Security & Compliance PowerShell herzustellen. Das Cmdlet funktioniert für MFA-fähige oder nicht MFA-fähige Konten.
Hinweis: Version 3.2.0 oder höher des Moduls unterstützt den REST-API-Modus für praktisch alle PowerShell-Cmdlets für die Sicherheits- & Compliance (die Standardauthentifizierung in WinRM auf dem lokalen Computer ist für den REST-API-Modus nicht erforderlich). Weitere Informationen finden Sie unter Voraussetzungen für das PowerShell-Modul in Exchange Online.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Connect-IPPSSession
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-DelegatedOrganization] <String>]
[[-PSSessionOption] <PSSessionOption>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-DisableWAM]
[-EnableErrorReporting]
[-EnableSearchOnlySession]
[-EXOModuleBasePath <String>]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-Organization <String>]
[-ShowBanner]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Beschreibung
Ausführliche Verbindungsanweisungen, einschließlich der Voraussetzungen, finden Sie unter Herstellen einer Verbindung mit Security & Compliance PowerShell.
Beispiele
Beispiel 1
Connect-IPPSSession -UserPrincipalName michelle@contoso.onmicrosoft.com
Dieses Beispiel stellt eine Verbindung mit Security & Compliance PowerShell über das angegebene Konto und moderne Authentifizierung mit oder ohne MFA her. In Version 3.2.0 oder höher des Moduls stellen wir eine Verbindung im REST-API-Modus her, sodass die Standardauthentifizierung in WinRM auf dem lokalen Computer nicht erforderlich ist.
Beispiel 2
Connect-IPPSSession -UserPrincipalName michelle@contoso.onmicrosoft.com -UseRPSSession
Dieses Beispiel stellt eine Verbindung mit Security & Compliance PowerShell über das angegebene Konto und moderne Authentifizierung mit oder ohne MFA her. In Version 3.2.0 oder höher des Moduls stellen wir eine Verbindung im Remote-PowerShell-Modus her, sodass die Standardauthentifizierung in WinRM auf dem lokalen Computer erforderlich ist.
Beispiel 3
Connect-IPPSSession -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
Dieses Beispiel stellt in einem unbeaufsichtigten Skriptszenario mithilfe eines Zertifikatfingerabdrucks eine Verbindung mit Security & Compliance PowerShell her.
Beispiel 4
Connect-IPPSSession -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
Dieses Beispiel stellt in einem unbeaufsichtigten Skriptszenario mithilfe einer Zertifikatdatei eine Verbindung mit Security & Compliance PowerShell her. Diese Methode eignet sich am besten für Szenarien, in denen das Zertifikat auf Remotecomputern gespeichert und zur Laufzeit abgerufen wird. Beispielsweise wird das Zertifikat in der Azure Key Vault gespeichert.
Parameter
-AccessToken
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.0-Preview1 oder höher verfügbar.
Der AccessToken-Parameter gibt das OAuth JSON Web Token (JWT) an, das zum Herstellen einer Verbindung mit Security and Compliance PowerShell verwendet wird.
Je nach Typ des Zugriffstokens müssen Sie diesen Parameter mit den Parametern Organization, DelegatedOrganization oder UserPrincipalName verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AppId
Anwendbar: Exchange Online
Der AppId-Parameter gibt die Anwendungs-ID des Dienstprinzipals an, der bei der zertifikatbasierten Authentifizierung (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 Nur-App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AzureADAuthorizationEndpointUri
Anwendbar: Exchange Online
Der Parameter AzureADAuthorizationEndpointUri gibt den Microsoft Entra-Autorisierungsendpunkt an, der OAuth2-Zugriffstoken ausgeben kann. Die folgenden PowerShell-Umgebungen und zugehörige Werte werden unterstützt:
- Sicherheits- & Compliance-PowerShell in Microsoft 365 oder Microsoft 365 GCC: Verwenden Sie diesen Parameter nicht. Der erforderliche Wert ist
https://login.microsoftonline.com/organizations, aber dies ist auch der Standardwert, sodass Sie diesen Parameter nicht verwenden müssen. - Sicherheits- & Compliance-PowerShell in Office 365, betrieben von 21Vianet:
https://login.chinacloudapi.cn/organizations - Security & Compliance PowerShell in Microsoft GCC High oder Microsoft DoD:
https://login.microsoftonline.us/organizations
Der URI-Wert, der auf /organizations Folgendes endet, erlaubt nur Geschäfts-, Schul- oder Unikonten. Der ältere URI-Wert, der auf /common Folgendes endet, funktioniert weiterhin, fordert Sie jedoch möglicherweise auf, zwischen einem persönlichen Konto und einem Geschäfts-, Schul- oder Unikonto auszuwählen. Wir empfehlen den /organizations URI-Wert in Unternehmensszenarien, in denen Heimanwenderkonten ausgeschlossen werden sollen.
Wenn Sie den Parameter "UserPrincipalName" 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 beide zu verwenden).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-BypassMailboxAnchoring
Anwendbar: Exchange Online
Der Schalter BypassMailboxAnchoring umgeht die Verwendung des Postfachverankerungshinweises. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Certificate
Anwendbar: Exchange Online
Der Parameter Certificate gibt das Zertifikat an, das für die zertifikatbasierte Authentifizierung (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 zu CBA finden Sie unter Nur-App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Parametereigenschaften
| Typ: | X509Certificate2 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificateFilePath
Anwendbar: Exchange Online
Der Parameter CertificateFilePath gibt das Zertifikat an, das für 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 Certificate- oder CertificateThumbprint-Parametern.
Weitere Informationen zu CBA finden Sie unter Nur-App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificatePassword
Anwendbar: Exchange Online
Der Parameter CertificatePassword gibt das Kennwort an, das zum Öffnen der Zertifikatdatei erforderlich ist, wenn Sie mithilfe des CertificateFilePath-Parameters das Zertifikat identifizieren, das für 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,
$password = Read-Host "Enter password" -AsSecureStringspeichern Sie das Kennwort als Variable (z. B. ), und verwenden Sie dann die Variable ($password) für den Wert. -
(Get-Credential).password, um bei Ausführung dieses Befehls zur sicheren Eingabe des Kennworts aufgefordert zu werden.
Weitere Informationen zu CBA finden Sie unter Nur-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 das Kennwort des Zertifikats sicher einzugeben, ist für Automatisierungsszenarien nicht ideal. Mit anderen Worten: Es gibt wirklich keine automatisierte und sichere Möglichkeit, eine Verbindung mithilfe eines lokalen Zertifikats herzustellen.
Parametereigenschaften
| Typ: | SecureString |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificateThumbprint
Anwendbar: Exchange Online
Der Parameter CertificateThumbprint gibt das Zertifikat an, das für CBA verwendet wird. Ein gültiger Wert ist der Fingerabdruckwert des Zertifikats. Beispiel: 83213AEAC56D61C97AEE5C1528F4AC5EBA7321C1.
Verwenden Sie diesen Parameter nicht mit den Certificate- oder CertificateFilePath-Parametern.
Hinweis: Der Parameter "CertificateThumbprint" wird nur in Microsoft Windows unterstützt.
Weitere Informationen zu CBA finden Sie unter Nur-App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CommandName
Anwendbar: Exchange Online
Der Parameter CommandName gibt die durch Kommas getrennte Liste der Befehle an, die in die Sitzung importiert werden sollen. Verwenden Sie diesen Parameter für Anwendungen oder Skripts, die einen bestimmten Satz von Cmdlets verwenden. Die Reduzierung der Anzahl von Cmdlets in der Sitzung trägt zur Verbesserung der Leistung bei und verringert den Speicherbedarf der Anwendung oder des Skripts.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 5 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ConnectionUri
Anwendbar: Exchange Online
Der Parameter ConnectionUri gibt den Verbindungsendpunkt für die PowerShell-Sitzung an. Die folgenden PowerShell-Umgebungen und zugehörige Werte werden unterstützt:
- Sicherheits- & 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. - Sicherheits- & Compliance-PowerShell in Office 365, betrieben von 21Vianet:
https://ps.compliance.protection.partner.outlook.cn/powershell-liveid - Security & Compliance PowerShell in Microsoft GCC High:
https://ps.compliance.protection.office365.us/powershell-liveid/ - Security & Compliance PowerShell in Microsoft DoD:
https://l5.ps.compliance.protection.office365.us/powershell-liveid/
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Anwendbar: Exchange Online
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 (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.
Nachdem der Befehl Connect-IPPSSession abgeschlossen wurde, wird der Kennwortschlüssel in der Variablen geleert.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DelegatedOrganization
Anwendbar: Exchange Online
Der Parameter DelegatedOrganization gibt die Kunden organization an, die Sie verwalten möchten (z. B. contosoelectronics.onmicrosoft.com). Dieser Parameter funktioniert nur, wenn die Kunden-Organization Ihrer delegierten Verwaltung über das CSP-Programm zugestimmt hat.
Nach erfolgreicher Authentifizierung werden die Cmdlets in dieser Sitzung der Kunden-organization zugeordnet, und alle Vorgänge in dieser Sitzung werden für die Kunden-organization ausgeführt.
Hinweise:
- Verwenden Sie die primäre .onmicrosoft.com-Domäne der delegierten organization für den Wert dieses Parameters.
- Sie müssen den Parameter AzureADAuthorizationEndpointUri mit diesem Parameter verwenden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DisableWAM
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.7.2-Preview1 oder höher verfügbar.
Der DisableWAM-Schalter deaktiviert Web Account Manager (WAM). Sie müssen keinen Wert für diese Option angeben.
Wenn während der Anmeldung WAM-bezogene Probleme auftreten, können Sie diesen Schalter verwenden, um WAM zu deaktivieren.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EnableErrorReporting
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.1-Preview1 oder höher verfügbar.
Die Befehlszeilenoption "EnableErrorReporting" gibt an, ob die Fehlerberichterstattung aktiviert werden soll. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EnableSearchOnlySession
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.9.0-Preview1 oder höher verfügbar.
Die Option EnableSearchOnlySession gibt an, ob bestimmte eDiscovery- und verwandte Cmdlets aktiviert werden sollen, die eine Verbindung mit anderen Microsoft 365-Diensten herstellen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EXOModuleBasePath
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.9.1-Preview1 oder höher verfügbar.
Der Parameter EXOModuleBasePath gibt den Ordner an, in dem die lokale temporäre Kopie des PowerShell-Moduls von Exchange Online gespeichert ist. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
Connect-ExchangeOnline Befehle speichern eine temporäre Kopie des Exchange Online Moduls lokal auf dem Client für Sitzungskonnektivität. Die temporäre Kopie des Moduls wird standardmäßig im Ordner %TMP% gespeichert (standardmäßig C:\Users\<UserName>\AppData\Local\Temp).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FormatTypeName
Anwendbar: Exchange Online
Der Parameter FormatTypeName gibt das Ausgabeformat des Cmdlets an.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 6 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LogDirectoryPath
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.1-Preview1 oder höher verfügbar.
Der LogDirectoryPath-Parameter gibt den Speicherort der Protokolldateien an. Der Standardspeicherort ist %TMP%\EXOCmdletTelemetry\EXOCmdletTelemetry-yyyymmdd-hhmmss.csv.
Wenn Sie einen benutzerdefinierten Speicherort und Dateinamen angeben, der Leerzeichen enthält, setzen Sie den Wert in Anführungszeichen (").
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LogLevel
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.1-Preview1 oder höher verfügbar.
Der LogLevel-Parameter gibt die Protokollierungsebene an. Gültige Werte sind "Standard" und "Alle".
Parametereigenschaften
| Typ: | LogLevel |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Organization
Anwendbar: Exchange Online
Der Parameter Organization gibt die organization an, wenn Sie eine Verbindung mithilfe von CBA herstellen. Sie müssen die primäre .onmicrosoft.com-Domäne der organization für den Wert dieses Parameters verwenden.
Weitere Informationen zu CBA finden Sie unter Nur-App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Prefix
Anwendbar: Exchange Online
Der Parameter Prefix gibt einen Textwert an, der beim Herstellen einer Verbindung an den Namen von PowerShell-Cmdlets für Sicherheits- & Compliance angehängt wird. Beispielsweise wird Get-ComplianceCase Get-ContosoComplianceCase, wenn Sie den Wert Contoso für diesen Parameter verwenden.
- Der Präfixwert darf keine Leer- 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 Security & Compliance-Cmdlet-Namen aus. Dies wirkt sich nicht auf die Namen von Cmdlets aus, die in das Modul integriert sind (z. B. Disconnect-ExchangeOnline).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 4 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PSSessionOption
Anwendbar: Exchange Online
Hinweis: Dieser Parameter funktioniert nicht in REST-API-Verbindungen.
Der Parameter PSSessionOption gibt die Remote-PowerShell-Sitzungsoptionen an, die in Ihrer Verbindung mit Security & Compliance PowerShell verwendet werden sollen. Dieser Parameter funktioniert nur, wenn Sie auch den UseRPSSession-Schalter im selben Befehl verwenden.
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. ).
Parametereigenschaften
| Typ: | PSSessionOption |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ShowBanner
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.2.0 oder höher verfügbar.
Der ShowBanner-Schalter zeigt oder blendet die Bannernachricht aus, die beim Ausführen von Connect-IPPSSession angezeigt wird. Sie müssen keinen Wert für diese Option angeben.
- Zum Anzeigen des Banners müssen Sie diesen Schalter nicht verwenden (das Banner wird standardmäßig angezeigt).
- Um das Banner auszublenden, verwenden Sie genau diese Syntax:
-ShowBanner:$false.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UserPrincipalName
Anwendbar: Exchange Online
Der Parameter UserPrincipalName gibt das Konto an, das Sie zum Herstellen einer Verbindung verwenden möchten (z. B navin@contoso.onmicrosoft.com. ). Mit diesem Parameter können Sie die Eingabe eines Benutzernamens in der Eingabeaufforderung für die Anmeldeinformationen für die moderne Authentifizierung überspringen (Sie werden zur Eingabe eines Kennworts aufgefordert).
Wenn Sie den Parameter "UserPrincipalName" 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 beide zu verwenden).
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UseRPSSession
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.9.2 oder höher veraltet. Remote-PowerShell-Verbindungen mit Security & Compliance PowerShell wurden im Oktober 2023 eingestellt. Weitere Informationen finden Sie unter Abschaffung von Remote PowerShell in Security and Compliance PowerShell.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| 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.