Freigeben über

Set-ClientAccessRule

Modul:
Exchange PowerShell

Hinweis

Clientzugriffsregeln waren im September 2025 für alle Exchange Online Organisationen veraltet. 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 oder höher funktionsfähig.

Verwenden Sie das Cmdlet Set-ClientAccessRule, um bestehende Clientzugriffsregeln zu ändern. 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

Default (Standard) 

Set-ClientAccessRule
    [-Identity] <ClientAccessRuleIdParameter>
    [-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>]
    [-Name <String>]
    [-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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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

Set-ClientAccessRule "Allow IMAP4" -AnyOfClientIPAddressesOrRanges @{Add="172.17.17.27/16"}

In diesem Beispiel wird der IP-Adressbereich 172.17.17.27/16 der bestehenden Clientzugriffsregel mit der Bezeichnung "IMAP4 zulassen" hinzugefügt, ohne dabei bestehende IP-Adresswerte zu beeinflussen.

Parameter

-Action

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Action gibt die Aktion für die Clientzugriffsregel an. Gültige Werte für diesen Parameter sind AllowAccess und DenyAccess.

Parametereigenschaften

Typ:ClientAccessRulesAction
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

-AnyOfAuthenticationTypes

Anwendbar: Exchange Server 2013, Exchange Server 2016

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-AnyOfClientIPAddressesOrRanges

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.
  • CIDR-IP-Adressbereich (Classless InterDomain Routing): Beispiel: 192.168.3.1/24 oder 2001:DB8::2AA:FF:C0A8:640A/64.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Weitere Informationen zu IPv6-Adressen und zur Syntax finden Sie in diesem Exchange 2013-Artikel: Grundlagen zu IPv6-Adressen.

Parametereigenschaften

Typ:MultiValuedProperty
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

-AnyOfProtocols

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Parametereigenschaften

Typ:MultiValuedProperty
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

-AnyOfSourceTcpPortNumbers

Anwendbar: Exchange Server 2013

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-Confirm

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainController

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:Fqdn
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

-Enabled

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Enabled gibt an, ob die Clientzugriffsregel aktiviert oder deaktiviert ist. Gültige Werte für diesen Parameter sind $true oder $false.

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

-ExceptAnyOfAuthenticationTypes

Anwendbar: Exchange Server 2013, Exchange Server 2016

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-ExceptAnyOfClientIPAddressesOrRanges

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.
  • CIDR-IP-Adressbereich (Classless InterDomain Routing): Beispiel: 192.168.3.1/24 oder 2001:DB8::2AA:FF:C0A8:640A/64.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Weitere Informationen zu IPv6-Adressen und zur Syntax finden Sie in diesem Exchange 2013-Artikel: Grundlagen zu IPv6-Adressen.

Parametereigenschaften

Typ:MultiValuedProperty
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

-ExceptAnyOfProtocols

Anwendbar: Exchange Server 2013, Exchange Server 2016

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-ExceptAnyOfSourceTcpPortNumbers

Anwendbar: Exchange Server 2013

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-ExceptUserIsMemberOf

Anwendbar: Exchange Server 2013

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-ExceptUsernameMatchesAnyOfPatterns

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Parametereigenschaften

Typ:MultiValuedProperty
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

-Identity

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Identity gibt die Clientzugriffsregel an, die Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der die Clientzugriffsregel eindeutig identifiziert. Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

Parametereigenschaften

Typ:ClientAccessRuleIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Name gibt einen eindeutigen Namen für die Clientzugriffsregel an.

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

-Priority

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Der Parameter Priority gibt einen Prioritätswert für die Clientzugriffsregel an. Ein niedrigerer ganzzahliger Wert gibt eine höhere Priorität an, und eine Regel mit höherer Priorität wird vor einer Regel mit niedrigerer Priorität ausgewertet. Der Standardwert ist 1.

Parametereigenschaften

Typ:Int32
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

-Scope

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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).

Parametereigenschaften

Typ:ClientAccessRulesScope
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

-UserIsMemberOf

Anwendbar: Exchange Server 2013

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:MultiValuedProperty
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

-UsernameMatchesAnyOfPatterns

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Parametereigenschaften

Typ:MultiValuedProperty
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

-UserRecipientFilter

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

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

-WhatIf

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

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.

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.