Freigeben über


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 . oder CustomAttribute1).
  • 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 beispielsweise 500$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, $falseoder $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.