New-ClientAccessRule
Hinweis
Ab Oktober 2022 sind Clientzugriffsregeln für alle Exchange Online Organisationen, die sie nicht verwendet haben, veraltet. Clientzugriffsregeln sind für alle verbleibenden Organisationen am 1. September 2025 veraltet. Wenn Sie clientzugriffsregeln vor ablauf der Frist deaktivieren möchten, wird das Feature in Ihrem organization deaktiviert. Weitere Informationen finden Sie unter Update on Client Access Rules Deprecation in Exchange Online.For more information, see Update on Client Access Rules Deprecation in Exchange Online.
Dieses Cmdlet ist nur in Exchange Server 2019 und im cloudbasierten Dienst funktionsfähig. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.
Verwenden Sie das Cmdlet New-ClientAccessRule, um Clientzugriffsregeln zu erstellen. Clientzugriffsregeln helfen Ihnen bei der Steuerung des Zugriffs auf Ihre Organisation basierend auf den Eigenschaften der Verbindung.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
New-ClientAccessRule
[-Name] <String>
-Action <ClientAccessRulesAction>
[-AnyOfAuthenticationTypes <MultiValuedProperty>]
[-AnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
[-AnyOfProtocols <MultiValuedProperty>]
[-AnyOfSourceTcpPortNumbers <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-ExceptAnyOfAuthenticationTypes <MultiValuedProperty>]
[-ExceptAnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
[-ExceptAnyOfProtocols <MultiValuedProperty>]
[-ExceptAnyOfSourceTcpPortNumbers <MultiValuedProperty>]
[-ExceptUserIsMemberOf <MultiValuedProperty>]
[-ExceptUsernameMatchesAnyOfPatterns <MultiValuedProperty>]
[-Priority <Int32>]
[-Scope <ClientAccessRulesScope>]
[-UserIsMemberOf <MultiValuedProperty>]
[-UsernameMatchesAnyOfPatterns <MultiValuedProperty>]
[-UserRecipientFilter <String>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Clientzugriffsregeln sind wie Nachrichtenflussregeln (auch als Transportregeln bezeichnet) für Clientverbindungen mit Ihrem organization. Sie verwenden Bedingungen und Ausnahmen, um die Verbindungen basierend auf ihren Eigenschaften und Aktionen zu identifizieren, die die Verbindungen zulassen oder blockieren.
Hinweis: Nicht alle Protokolle unterstützen Authentifizierungstypfilter, und selbst Protokolle, die Authentifizierungstypfilter unterstützen, unterstützen nicht alle Authentifizierungstypen. Die unterstützten Kombinationen werden in den folgenden Listen beschrieben. Seien Sie vorsichtig, wenn Sie Protokolle und Authentifizierungstypen in derselben Regel kombinieren.
Protokolle, die Authentifizierungstypfilter unterstützen:
- ExchangeActiveSync: BasicAuthentication, OAuthAuthentication und CertificateBasedAuthentication.
- ExchangeAdminCenter: BasicAuthentication und AdfsAuthentication.
- IMAP4: BasicAuthentication und OAuthAuthentication.
- OutlookWebApp: BasicAuthentication und AdfsAuthentication.
- POP3: BasicAuthentication und OAuthAuthentication.
- RemotePowerShell: BasicAuthentication und NonBasicAuthentication.
Protokolle, die keine Authentifizierungstypfilter unterstützen:
- ExchangeWebServices
- OfflineAddressBook
- OutlookAnywhere
- PowerShellWebServices
- REST
- UniversalOutlook
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
New-ClientAccessRule -Name AllowRemotePS -Action Allow -AnyOfProtocols RemotePowerShell -Priority 1
In diesem Beispiel wird eine Regel mit der höchsten Priorität erstellt, die den Zugriff auf Remote-PowerShell zulässt. Diese Regel ist ein wichtiger Schutz, um den Zugriff auf Ihre organization zu erhalten. Wenn Sie ohne diese Regel Regeln erstellen, die Den Zugriff auf Remote-PowerShell blockieren oder alle Protokolle für alle blockieren, verlieren Sie die Möglichkeit, die Regeln selbst zu korrigieren (Sie müssen den Microsoft-Kundendienst und -Support anrufen).
Beispiel 2
New-ClientAccessRule -Name "Block ActiveSync" -Action DenyAccess -AnyOfProtocols ExchangeActiveSync -ExceptAnyOfClientIPAddressesOrRanges 192.168.10.1/24
In diesem Beispiel wird eine neue Clientzugriffsregel mit dem Namen ActiveSync blockieren erstellt, die den Zugriff für Exchange ActiveSync Clients mit Ausnahme von Clients im IP-Adressbereich 192.168.10.1/24 blockiert.
Parameter
-Action
Der Parameter Action gibt die Aktion für die Clientzugriffsregel an. Gültige Werte für diesen Parameter sind AllowAccess und DenyAccess.
Typ: | ClientAccessRulesAction |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AnyOfAuthenticationTypes
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter AnyOfAuthenticationTypes gibt für die Clientzugriffsregel eine Bedingung an, die auf dem Authentifizierungstyp des Clients basiert.
Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- AdfsAuthentication
- BasicAuthentication
- CertificateBasedAuthentication
- NonBasicAuthentication
- OAuthAuthentication
Mehrere Werte können durch Kommata getrennt eingegeben werden. Verwenden Sie keine Anführungszeichen.
Hinweis: Im Abschnitt Beschreibung erfahren Sie, welche Authentifizierungstypen mit welchen Protokollen verwendet werden können.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection |
-AnyOfClientIPAddressesOrRanges
Der Parameter AnyOfClientIPAddressesOrRanges gibt eine Bedingung für die Clientzugriffsregel an, die auf der IPv4- oder IPv6-Adresse des Clients basiert. Gültige Werte sind:
- Einzelne IP-Adresse: Beispiel: 192.168.1.1 oder 2001:DB8::2AA:FF:C0A8:640A.
- IP-Adressbereich: Beispiel: 192.168.0.1-192.168.0.254 oder 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414.
- IP-Adressbereich ohne Inter-Domain Routing (CIDR): Beispiel: 192.168.3.1/24 oder 2001:DB8::2AA:FF:C0A8:640A/64.
Mehrere Werte können durch Kommata getrennt eingegeben werden.
Weitere Informationen zu IPv6-Adressen und zur Syntax finden Sie in diesem Exchange 2013-Thema: IPv6-Adressgrundlagen.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AnyOfProtocols
Der Parameter AnyOfProtocols gibt für die Clientzugriffsregel eine Bedingung an, die auf dem Protokoll des Clients basiert.
Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- ExchangeActiveSync
- ExchangeAdminCenter
- ExchangeWebServices
- IMAP4
- OfflineAddressBook
- OutlookAnywhere
- OutlookWebApp
- POP3
- PowerShellWebServices
- RemotePowerShell
- REST
- UniversalOutlook (Mail- und Kalender-App)
Hinweis: In Exchange 2019 werden nur ExchangeAdminCenter und RemotePowerShell unterstützt.
Mehrere Werte können durch Kommata getrennt eingegeben werden. Verwenden Sie keine Anführungszeichen.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AnyOfSourceTcpPortNumbers
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013 |
-Confirm
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false
. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Dieses Cmdlet verfügt über eine integrierte Pause. Verwenden Sie -Confirm:$false
daher , um die Bestätigung zu überspringen.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Typ: | Fqdn |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Der Parameter Enabled gibt an, ob die Clientzugriffsregel aktiviert oder deaktiviert ist. Gültige Werte für diesen Parameter sind $true oder $false. Der Standardwert lautet $true.
Typ: | Boolean |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ExceptAnyOfAuthenticationTypes
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter ExceptAnyOfAuthenticationTypes gibt für die Clientzugriffsregel eine Ausnahme an, die auf dem Authentifizierungstyp des Clients basiert.
Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- AdfsAuthentication
- BasicAuthentication
- CertificateBasedAuthentication
- NonBasicAuthentication
- OAuthAuthentication
Mehrere Werte können durch Kommata getrennt eingegeben werden. Verwenden Sie keine Anführungszeichen.
Hinweis: Im Abschnitt Beschreibung erfahren Sie, welche Authentifizierungstypen mit welchen Protokollen verwendet werden können.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection |
-ExceptAnyOfClientIPAddressesOrRanges
Der Parameter ExceptAnyOfClientIPAddressesOrRanges gibt eine Ausnahme für die Clientzugriffsregel an, die auf der IPv4- oder IPv6-Adresse des Clients basiert. Gültige Werte sind:
- Einzelne IP-Adresse: Beispiel: 192.168.1.1 oder 2001:DB8::2AA:FF:C0A8:640A.
- IP-Adressbereich: Beispiel: 192.168.0.1-192.168.0.254 oder 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414.
- IP-Adressbereich ohne Inter-Domain Routing (CIDR): Beispiel: 192.168.3.1/24 oder 2001:DB8::2AA:FF:C0A8:640A/64.
Mehrere Werte können durch Kommata getrennt eingegeben werden.
Weitere Informationen zu IPv6-Adressen und zur Syntax finden Sie in diesem Exchange 2013-Thema: IPv6-Adressgrundlagen.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ExceptAnyOfProtocols
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter ExceptAnyOfProtocols gibt für die Clientzugriffsregel eine Ausnahme an, die auf dem Protokoll des Clients basiert.
Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.
- ExchangeActiveSync
- ExchangeAdminCenter
- ExchangeWebServices
- IMAP4
- OfflineAddressBook
- OutlookAnywhere
- OutlookWebApp
- POP3
- PowerShellWebServices
- RemotePowerShell
- REST
- UniversalOutlook (Mail- und Kalender-App)
Mehrere Werte können durch Kommata getrennt eingegeben werden. Verwenden Sie keine Anführungszeichen.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Online, Exchange Online Protection |
-ExceptAnyOfSourceTcpPortNumbers
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013 |
-ExceptUserIsMemberOf
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013 |
-ExceptUsernameMatchesAnyOfPatterns
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter ExceptUsernameMatchesAnyOfPatterns gibt eine Ausnahme für die Clientzugriffsregel an, die auf dem Kontonamen des Benutzers im Format <Domain>\<UserName>
basiert (z. B contoso.com\jeff
. ). Dieser Parameter akzeptiert Text und das Platzhalterzeichen (*) (z. B. *jeff*
, aber nicht jeff*
). Für nicht alphanumerische Zeichen sind keine Escapezeichen erforderlich.
Mehrere Werte können durch Kommata getrennt eingegeben werden.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Der Parameter Name gibt einen eindeutigen Namen für die Clientzugriffsregel an.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Priority
Der Parameter Priority gibt einen Prioritätswert für die Regel an, der die Reihenfolge der Regelverarbeitung bestimmt. Ein niedrigerer Ganzzahlwert deutet eine höhere Priorität an. Der Wert „0“ entspricht der höchsten Priorität. Regeln können zudem nicht über denselben Prioritätswert verfügen.
Gültige Werte und der Standardwert für diesen Parameter hängen von der Anzahl der vorhandenen Regeln ab. Wenn beispielsweise 8 Regeln vorhanden sind:
- Gültige Werte und der Standardwert für diesen Parameter hängen von der Anzahl der vorhandenen Regeln ab. Wenn beispielsweise 8 Regeln vorhanden sind:
- Reichen die gültigen Prioritätswerte für die vorhandenen 8 Regeln von 0 bis 7.
- Reichen die gültigen Prioritätswerte für eine neue Regel (die 9. Regel) von 0 bis 8.
Entspricht der Standardwert für eine neue Regel (die 9. Regel) 8.
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Scope
Der Parameter Scope gibt den Bereich der Clientzugriffsregel an. Gültige Werte sind:
- Users: Die Regel gilt nur für Endbenutzerverbindungen.
- All: Die Regel gilt für alle Verbindungen (Endbenutzer und Middle-Tier-Apps).
Typ: | ClientAccessRulesScope |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UserIsMemberOf
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013 |
-UsernameMatchesAnyOfPatterns
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter UsernameMatchesAnyOfPatterns gibt eine Bedingung für die Clientzugriffsregel an, die auf dem Kontonamen des Benutzers im Format <Domain>\<UserName>
basiert (z. B contoso.com\jeff
. ). Dieser Parameter akzeptiert Text und das Platzhalterzeichen (*) (z. B. *jeff*
, aber nicht jeff*
). Für nicht alphanumerische Zeichen sind keine Escapezeichen erforderlich. Dieser Parameter funktioniert nicht mit dem UniversalOutlook-Parameter -AnyOfProtocols.
Mehrere Werte können durch Kommata getrennt eingegeben werden.
Typ: | MultiValuedProperty |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | True |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UserRecipientFilter
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Parameter UserRecipientFilter gibt eine Bedingung für die Clientzugriffsregel an, die die OPATH-Filtersyntax verwendet, um den Benutzer basierend auf einer begrenzten Gruppe von Empfängereigenschaften zu identifizieren. Clientzugriffsregeln unterstützen nicht die vollständige Liste der verfügbaren Empfängereigenschaften.
Sie können die folgenden Eigenschaften mit diesem Parameter verwenden:
- Stadt
- Company
- CountryOrRegion (ISO 3166-1 Alpha-2-Ländercode))
- "CustomAttribute1" bis "CustomAttribute15"
- Department
- Büro
- PostalCode
- StateOrProvince
- StreetAddress
Die grundlegende Syntax für diesen Parameter lautet "Property -ComparisonOperator 'Value'"
:
- Die Eigenschaft ist eine der filterbaren Eigenschaften in der obigen Liste (z. B
City
. oderCustomAttribute1
). - ComparisonOperator ist ein OPATH-Vergleichsoperator (z. B
-eq
. für gleich und-like
für den Zeichenfolgenvergleich). Weitere Informationen über Vergleichsoperatoren finden Sie unter about_Comparison_Operators. - Wert ist der zu suchende Eigenschaftswert. Fügen Sie Textwerte und Variablen in einfache Anführungszeichen (
'Value'
oder'$Variable'
) ein. Wenn ein Variablenwert einfache Anführungszeichen enthält, müssen Sie die einfachen Anführungszeichen identifizieren (escape), um die Variable korrekt zu erweitern. Sie können z. B.'$($User -Replace "'","''")'
anstelle von'$User'
verwenden. Schließen Sie keine ganzen Zahlen oder Systemwerte in Anführungszeichen ein (verwenden Sie stattdessen beispielsweise500
$true
,$false
oder$null
). - Schließen Sie den gesamten OPATH-Filter in doppelte Anführungszeichen " ein. Wenn der Filter Systemwerte enthält (z. B.
$true
,$false
oder$null
), verwenden Sie stattdessen einfache Anführungszeichen ''. Obwohl dieser Parameter eine Zeichenfolge ist (kein Systemblock), können Sie auch geschweifte Klammern { } verwenden, jedoch nur, wenn der Filter keine Variablen enthält.
Zum Beispiel:
"City -eq 'Redmond'"
-
"CountryOrRegion -eq 'SG'"
.
Sie können mehrere Suchkriterien mithilfe der logischen Operatoren -and
und -or
miteinander verketten. Zum Beispiel:
"CustomAttribute1 -eq 'AllowOWA' -and CountryOrRegion -eq AU'"
-
"(CountryOrRegion -eq 'US' -and Department -eq 'Sales') -or Department -eq 'Research'"
.
Ausführliche Informationen zur OPATH-Filtersyntax in Exchange finden Sie unter Zusätzliche Informationen zur OPATH-Syntax.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WhatIf
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Gilt für:: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.