Connect-ExchangeOnline
Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.
Verwenden Sie das Cmdlet Connect-ExchangeOnline im Exchange Online PowerShell-Modul, um die moderne Authentifizierung zum Herstellen einer Verbindung mit Exchange Online PowerShell oder Exchange Online Protection PowerShell für den Cloudschutz von lokalen E-Mail-Umgebungen zu verwenden. Dieses Cmdlet funktioniert für Konten mit oder ohne mehrstufige Authentifizierung (Multi-Factor Authentication, MFA).
Verwenden Sie zum Herstellen einer Verbindung mit Security & Compliance PowerShell das Cmdlet Connect-IPPSSession .
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Connect-ExchangeOnline
[[-ConnectionUri] <String>]
[[-AzureADAuthorizationEndpointUri] <String>]
[[-ExchangeEnvironmentName] <ExchangeEnvironment>]
[[-PSSessionOption] <PSSessionOption>]
[[-DelegatedOrganization] <String>]
[[-Prefix] <String>]
[[-CommandName] <String[]>]
[[-FormatTypeName] <String[]>]
[-AccessToken <String>]
[-AppId <String>]
[-BypassMailboxAnchoring]
[-Certificate <X509Certificate2>]
[-CertificateFilePath <String>]
[-CertificatePassword <SecureString>]
[-CertificateThumbprint <String>]
[-Credential <PSCredential>]
[-Device]
[-DisableWAM]
[-EnableErrorReporting]
[-EXOModuleBasePath <String>]
[-InlineCredential]
[-LoadCmdletHelp]
[-LogDirectoryPath <String>]
[-LogLevel <LogLevel>]
[-ManagedIdentity]
[-ManagedIdentityAccountId <String>]
[-Organization <String>]
[-PageSize <UInt32>]
[-ShowBanner]
[-ShowProgress <Boolean>]
[-SigningCertificate <X509Certificate2>]
[-SkipLoadingCmdletHelp]
[-SkipLoadingFormatData]
[-TrackPerformance <Boolean>]
[-UseMultithreading <Boolean>]
[-UserPrincipalName <String>]
[-UseRPSSession]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt eine PowerShell-Verbindung mit Ihrem Exchange Online organization.
Verbindungsbefehle schlagen wahrscheinlich fehl, wenn der Profilpfad des Kontos, das Sie für die Verbindung verwendet haben, $spezielle PowerShell-Zeichen enthält (z. B. ). Die Problemumgehung besteht darin, eine Verbindung mit einem anderen Konto herzustellen, das keine Sonderzeichen im Profilpfad enthält.
Beispiele
Beispiel 1
Connect-ExchangeOnline -UserPrincipalName chris@contoso.com
In diesem Beispiel wird eine Verbindung mit Exchange Online PowerShell hergestellt, wobei moderne Authentifizierung mit oder ohne mehrstufige Authentifizierung (Multi-Factor Authentication, MFA) verwendet wird. Die Verbindung verwendet den REST-API-Modus und erfordert keine Aktivierung der Standardauthentifizierung in WinRM auf dem lokalen Computer.
Beispiel 2
Connect-ExchangeOnline -AppId <%App_id%> -CertificateThumbprint <%Thumbprint string of certificate%> -Organization "contoso.onmicrosoft.com"
In diesem Beispiel wird eine Verbindung mit Exchange Online PowerShell in einem Szenario für die unbeaufsichtigte Skripterstellung mithilfe eines Zertifikatfingerabdrucks hergestellt.
Beispiel 3
Connect-ExchangeOnline -AppId <%App_id%> -Certificate <%X509Certificate2 object%> -Organization "contoso.onmicrosoft.com"
In diesem Beispiel wird eine Verbindung mit Exchange Online PowerShell in einem Szenario für die unbeaufsichtigte Skripterstellung mithilfe einer Zertifikatdatei hergestellt. Diese Methode eignet sich am besten für Szenarien, in denen das Zertifikat auf Remotecomputern gespeichert und zur Laufzeit abgerufen wird. Das Zertifikat wird beispielsweise im Azure Key Vault gespeichert.
Beispiel 4
Connect-ExchangeOnline -Device
In PowerShell 7.0.3 oder höher mit Version 2.0.4 oder höher des Moduls stellt dieses Beispiel eine Verbindung mit Exchange Online PowerShell in interaktiven Skriptszenarien auf Computern ohne Webbrowser her.
Der Befehl gibt eine URL und einen eindeutigen Code zurück, der an die Sitzung gebunden ist. Sie müssen die URL in einem Browser auf einem beliebigen Computer öffnen und dann den eindeutigen Code eingeben. Nachdem Sie die Anmeldung im Webbrowser abgeschlossen haben, wird die Sitzung im PowerShell 7-Fenster über den regulären Authentifizierungsablauf Microsoft Entra authentifiziert, und die Exchange Online Cmdlets werden nach einigen Sekunden importiert.
Beispiel 6
Connect-ExchangeOnline -InlineCredential
In PowerShell 7.0.3 oder höher mit Version 2.0.4 oder höher des Moduls stellt dieses Beispiel eine Verbindung mit Exchange Online PowerShell in Szenarien mit interaktiven Skripts her, indem Anmeldeinformationen direkt im PowerShell-Fenster übergeben werden.
Parameter
-AccessToken
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.1.0-Preview1 oder höher verfügbar.
Der Parameter AccessToken gibt das OAuth JSON Web Token (JWT) an, das zum Herstellen einer Verbindung mit Exchange Online verwendet wird.
Abhängig vom 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 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.
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
Hinweis: Wenn Sie den Parameter ExchangeEnvironmentName verwenden, müssen Sie die Parameter AzureADAuthorizationEndpointUri oder ConnectionUri nicht verwenden.
Der Parameter AzureADAuthorizationEndpointUri gibt den Microsoft Entra Autorisierungsendpunkt an, der OAuth2-Zugriffstoken ausgeben kann. Die folgenden Exchange Online PowerShell-Umgebungen und zugehörige Werte werden unterstützt:
- 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. - Office 365 Deutschland:
https://login.microsoftonline.de/organizations - Microsoft 365 GCC High oder Microsoft 365 DoD:
https://login.microsoftonline.us/organizations
Der URI-Wert, der auf /organizations endet, lässt nur Geschäfts-, Schul- oder Unikonten zu. Der ältere URI-Wert, der auf /common endet, funktioniert weiterhin, fordert Sie jedoch möglicherweise auf, zwischen einem persönliches Konto und einem Geschäfts-, Schul- oder Unikonto zu wählen. Wir empfehlen den /organizations URI-Wert in Unternehmensszenarien, in denen Consumerkonten ausgeschlossen werden sollten.
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).
Hinweis: MFA-Authentifizierung oder Verbundauthentifizierung ist in Office 365, die von 21Vianet betrieben wird, nicht verfügbar.
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 BypassMailboxAnchoring-Schalter umgeht die Verwendung des Postfachankerhinweises. Sie müssen keinen Wert für diese Option angeben.
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 |
-Certificate
Anwendbar: Exchange Online
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.
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 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.
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 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).passwordaufgefordert 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.
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 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.
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 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.
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 |
-ConnectionUri
Anwendbar: Exchange Online
Hinweis: Wenn Sie den Parameter ExchangeEnvironmentName verwenden, müssen Sie die Parameter AzureADAuthorizationEndpointUri oder ConnectionUri nicht verwenden.
Der ConnectionUri-Parameter gibt den Verbindungsendpunkt für die PowerShell-Sitzung an. Die folgenden Exchange Online PowerShell-Umgebungen und zugehörige Werte werden unterstützt:
- Microsoft 365 oder Microsoft 365 GCC: Verwenden Sie diesen Parameter nicht. Der erforderliche Wert ist
https://outlook.office365.com/powershell-liveid/, aber dies ist auch der Standardwert, sodass Sie diesen Parameter nicht verwenden müssen. - Office 365 Deutschland:
https://outlook.office.de/PowerShell-LiveID - Office 365 betrieben von 21Vianet:
https://partner.outlook.cn/PowerShell - Microsoft 365 GCC High:
https://outlook.office365.us/powershell-liveID - Microsoft 365 DoD:
https://webmail.apps.mil/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 (Multi-Factor Authentication, MFA) verwenden.
Bevor Sie den Befehl Connect-ExchangeOnline 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-ExchangeOnline Befehls wird der Kennwortschlüssel in der Variablen geleert.
Verwenden Sie diesen Parameter nicht, um das Kennwort für eine Zertifikatdatei anzugeben. Verwenden Sie stattdessen den Parameter CertificatePassword.
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 kundenseitig organization an, die Sie verwalten möchten. Ein gültiger Wert für diesen Parameter ist die primäre .onmicrosoft.com-Domäne oder Mandanten-ID des Kunden organization.
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.
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 |
-Device
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 2.0.4-Preview6 oder höher und nur in PowerShell 7 verfügbar.
Der Geräteschalter wird in der Regel auf Computern ohne Webbrowser verwendet. Sie müssen keinen Wert für diese Option angeben.
Die Verwendung dieses Schalters führt zu einer Meldung auf dem Bildschirm, die die URL https://microsoft.com/devicelogin und einen eindeutigen Code enthält. Öffnen Sie auf jedem anderen Gerät mit Webbrowser und Internetzugriff die URL, geben Sie den eindeutigen Code ein, und geben Sie Ihre Anmeldeinformationen auf den nachfolgenden Seiten ein.
Wenn Ihre Anmeldung erfolgreich war, wird die PowerShell-Verbindung fortgesetzt.
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 |
-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.
Ab Version 3.7.0 ist WAM standardmäßig aktiviert, wenn eine Verbindung mit Exchange Online hergestellt wird. Wenn bei 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
Der EnableErrorReporting-Schalter 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 |
-ExchangeEnvironmentName
Anwendbar: Exchange Online
ExchangeEnvironmentName gibt die Exchange Online Umgebung an und entfällt die Notwendigkeit, die Parameter AzureADAuthorizationEndpointUri und ConnectionUri zu verwenden. Die folgenden Exchange Online PowerShell-Umgebungen werden unterstützt:
- Microsoft 365 oder Microsoft 365 GCC: Verwenden Sie diesen Parameter nicht. Der erforderliche Wert ist
O365Default, aber dies ist auch der Standardwert, sodass Sie diesen Parameter nicht verwenden müssen. - Office 365 Deutschland:
O365GermanyCloud - Office 365 betrieben von 21Vianet:
O365China - Microsoft 365 GCC High:
O365USGovGCCHigh - Microsoft 365 DoD:
O365USGovDoD
Parametereigenschaften
| Typ: | ExchangeEnvironment |
| Standardwert: | O365Default |
| 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 |
-EXOModuleBasePath
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.9.1-Preview1 oder höher verfügbar.
Der EXOModuleBasePath-Parameter gibt den Ordner an, in dem die lokale temporäre Kopie des Exchange Online PowerShell-Moduls 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 die Sitzungskonnektivität. Standardmäßig wird die temporäre Kopie des Moduls 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: | 7 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InlineCredential
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 2.0.4-Preview6 oder höher und nur in PowerShell 7 verfügbar.
Der Schalter InlineCredential gibt an, ob Anmeldeinformationen direkt im Windows PowerShell-Fenster übergeben werden sollen. Sie müssen keinen Wert für diese Option angeben.
Dieser Schalter ähnelt dem Credential-Parameter, weist jedoch zusätzliche Sicherheit auf. Der Schalter InlineCredential erfordert nicht, dass Sie die Anmeldeinformationen lokal im Skript speichern, und Sie können Anmeldeinformationen direkt in einer interaktiven PowerShell-Sitzung eingeben.
Dieser Schalter funktioniert nicht mit Konten, die MFA verwenden.
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 |
-LoadCmdletHelp
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.7.0-Preview1 oder höher verfügbar.
Der LoadCmdletHelp-Schalter lädt Cmdlet-Hilfedateien für das Cmdlet Get-Help in REST-API-Verbindungen herunter. Sie müssen keinen Wert für diese Option angeben.
Ab v3.7.0-Preview1 werden Hilfedateien für die Befehlszeile nicht standardmäßig heruntergeladen. Verwenden Sie diesen Schalter, um die Dateien für die Cmdlet-Hilfe in der Befehlszeile herunterzuladen.
Tipp: Dieser Parameter ersetzt den SkipLoadingCmdletHelp-Parameter. Der SkipLoadingCmdletHelp-Parameter ist nicht mehr erforderlich und funktioniert nicht mehr, da Cmdlet-Hilfedateien nicht mehr standardmäßig heruntergeladen werden.
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 |
-LogDirectoryPath
Anwendbar: Exchange Online
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, schließen Sie den Wert in Anführungszeichen (") ein.
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
Der LogLevel-Parameter gibt den Protokolliergrad an. Gültige Werte sind Default und All.
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 |
-ManagedIdentity
Anwendbar: Exchange Online
Der Switch ManagedIdentity gibt an, dass Sie eine verwaltete Identität verwenden, um eine Verbindung herzustellen. Sie müssen keinen Wert für diese Option angeben.
Verbindungen mit verwalteten Identitäten werden derzeit für die folgenden Arten von Azure-Ressourcen unterstützt:
- Azure Automation Runbooks
- Virtuelle Azure-Computer
- Azure Virtual Machine Scale Sets
- Azure Functions
Sie müssen diesen Schalter mit dem Parameter Organization verwenden.
Für benutzerseitig zugewiesene verwaltete Identitäten müssen Sie diesen Schalter auch mit dem Parameter ManagedIdentityAccountId verwenden.
Weitere Informationen zum Herstellen einer Verbindung mit einer verwalteten Identität finden Sie unter Verwenden von Azure verwalteten Identitäten zum Herstellen einer Verbindung mit Exchange Online PowerShell.
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 |
-ManagedIdentityAccountId
Anwendbar: Exchange Online
Der Parameter ManagedIdentityAccountId gibt die benutzerseitig zugewiesene verwaltete Identität an, die Sie zum Herstellen einer Verbindung verwenden. Ein gültiger Wert für diesen Parameter ist die Anwendungs-ID (GUID) des Dienstprinzipals, die der benutzerseitig zugewiesenen verwalteten Identität in Azure entspricht.
Sie müssen diesen Parameter mit dem Parameter Organization und dem Switch ManagedIdentity verwenden.
Weitere Informationen zum Herstellen einer Verbindung mit einer verwalteten Identität finden Sie unter Verwenden von Azure verwalteten Identitäten zum Herstellen einer Verbindung mit Exchange Online PowerShell.
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 |
-Organization
Anwendbar: Exchange Online
Der Parameter Organization gibt die organization an, wenn Sie eine Verbindung mit CBA oder verwalteter Identität herstellen. Ein gültiger Wert für diesen Parameter ist die primäre .onmicrosoft.com-Domäne oder Mandanten-ID des organization.
Weitere Informationen zum Herstellen einer Verbindung mit CBA finden Sie unter Reine App-Authentifizierung für unbeaufsichtigte Skripts im Exchange Online PowerShell-Modul.
Weitere Informationen zum Herstellen einer Verbindung mit einer verwalteten Identität finden Sie unter Verwenden von Azure verwalteten Identitäten zum Herstellen einer Verbindung mit Exchange Online PowerShell.
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 |
-PageSize
Anwendbar: Exchange Online
Der PageSize-Parameter gibt die maximale Anzahl von Einträgen pro Seite an. Gültige Eingabewerte für diesen Parameter sind ganze Zahlen zwischen 1 und 1000. Der Standardwert ist 1000.
Parametereigenschaften
| Typ: | UInt32 |
| 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 den Namen Exchange Online PowerShell-Cmdlets hinzugefügt werden soll, wenn Sie eine Verbindung herstellen. Beispielsweise wird Get-InboundConnector Get-ContosoInboundConnector, 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 Exchange Online 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: | 5 |
| 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 PSSessionOption-Parameter gibt die PowerShell-Sitzungsoptionen an, die in Ihrer Verbindung mit Exchange Online verwendet werden sollen. Dieser Parameter funktioniert nur, wenn Sie auch den Schalter UseRPSSession 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
Der Schalter ShowBanner zeigt die Bannermeldung an oder blendet sie aus, die beim Ausführen von Connect-ExchangeOnline angezeigt wird. Sie müssen keinen Wert für diese Option angeben.
- Um das Banner anzuzeigen, müssen Sie diesen Schalter nicht verwenden (das Banner wird standardmäßig angezeigt).
- Um das Banner auszublenden, verwenden Sie genau die folgende Syntax:
-ShowBanner:$false.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | $true |
| 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 |
-ShowProgress
Anwendbar: Exchange Online
Der ShowProgress-Parameter gibt an, ob die Statusanzeige importierter Cmdlets beim Herstellen einer Verbindung ein- oder ausgeblendet werden soll. Gültige Werte sind:
- $true: Die Statusanzeige wird angezeigt. Dieser Wert ist die Standardeinstellung.
- $false: Dieser Wert hat derzeit keine Auswirkung.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-SigningCertificate
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.2.0-Preview4 oder höher verfügbar.
Der Parameter SigningCertificate gibt das Clientzertifikat an, das zum Signieren der Formatdateien (* verwendet wird. Format.ps1xml) oder Skriptmoduldateien (.psm1) im temporären Modul, das Connect-ExchangeOnline erstellt.
Ein gültiger Wert für diesen Parameter ist eine Variable, die das Zertifikat enthält, oder ein Befehl oder Ausdruck, der das Zertifikat abruft.
Um das Zertifikat zu finden, verwenden Sie das Cmdlet Get-PfxCertificate im Modul Microsoft.PowerShell.Security oder das Cmdlet Get-ChildItem auf dem Zertifikatlaufwerk (Cert:). Wenn das Zertifikat nicht gültig ist oder nicht über ausreichende Autorität verfügt, schlägt der Befehl fehl.
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 |
-SkipLoadingCmdletHelp
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.3.0-Preview1 oder höher verfügbar.
In Version 3.7.0-Preview1 oder höher wird dieser Parameter durch den Parameter LoadCmdletHelp ersetzt. Der SkipLoadingCmdletHelp-Parameter ist nicht mehr erforderlich und führt keine Aktionen mehr aus, da Cmdlet-Hilfedateien nicht mehr standardmäßig heruntergeladen werden.
Die SkipLoadingCmdletHelp-Option verhindert das Herunterladen der Cmdlet-Hilfedateien für das cmdlet Get-Help in REST-API-Verbindungen. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Schalter verwenden, erhalten Sie keine lokalen Hilfedateien für cmdlets in der Befehlszeile.
Dieser Schalter funktioniert nicht mit dem UseRPSSession-Schalter.
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 |
-SkipLoadingFormatData
Anwendbar: Exchange Online
Der Schalter SkipLoadingFormatData verhindert das Herunterladen der Formatdaten für REST-API-Verbindungen. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Schalter verwenden, ist die Ausgabe jedes Exchange-Cmdlets unformatiert.
Verwenden Sie diesen Schalter, um Fehler beim Herstellen einer Verbindung mit Exchange Online PowerShell aus einem Windows-Dienst oder dem Windows PowerShell SDK zu vermeiden.
Dieser Schalter funktioniert nicht mit dem UseRPSSession-Schalter.
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 |
-TrackPerformance
Anwendbar: Exchange Online
Der Parameter TrackPerformance misst zusätzliche Ereignisse (z. B. CPU-Auslastung und verbrauchter Arbeitsspeicher). Gültige Werte sind:
- $true: Die Leistungsnachverfolgung ist aktiviert.
- $false: Die Leistungsnachverfolgung ist deaktiviert. Dieser Wert ist die Standardeinstellung.
Dieser Parameter funktioniert nur, wenn die Protokollierung aktiviert ist.
Parametereigenschaften
| Typ: | Boolean |
| 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 |
-UseMultithreading
Anwendbar: Exchange Online
Der UseMultithreading-Parameter gibt an, ob Multithreading im Exchange Online PowerShell-Modul deaktiviert oder aktiviert werden soll. Gültige Werte sind:
- $true: Aktivieren Sie Multithreading. Dieser Wert ist die Standardeinstellung.
- $false: Multithreading deaktivieren. Dieser Wert beeinträchtigt die Leistung der neun exklusiven Get-EXO*- Cmdlets im Modul.
Parametereigenschaften
| Typ: | Boolean |
| 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, 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).
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: Remote-PowerShell-Verbindungen mit Exchange Online PowerShell sind veraltet. Weitere Informationen finden Sie unter Einstellung von Remote PowerShell in Exchange Online.
Mit dem Schalter UseRPSSession können Sie eine Verbindung mit Exchange Online PowerShell herstellen, indem Sie den herkömmlichen Remotezugriff von PowerShell auf alle Cmdlets verwenden. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Schalter nicht verwenden, wird der REST-API-Modus für die Verbindung verwendet, sodass keine Standardauthentifizierung in WinRM erforderlich ist.
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.