New-AdaptiveScope

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Security & Compliance

Dieses Cmdlet ist nur in PowerShell zur Sicherheitskonformität & verfügbar. Weitere Informationen finden Sie unter Security & Compliance PowerShell.

Verwenden Sie das Cmdlet New-AdaptiveScope, um adaptive Bereiche in Ihrer Organisation zu erstellen. Adaptive Bereiche (oder statische Bereiche) werden in Aufbewahrungsrichtlinien und Aufbewahrungsbezeichnungsrichtlinien verwendet.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

New-AdaptiveScope
   -Name <String>
   -FilterConditions <PswsHashtable>
   -LocationType <DynamicBoundaryLocationType>
   [-Comment <String>]
   [<CommonParameters>]
New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-Comment <String>]
   [<CommonParameters>]

Beschreibung

Weitere Informationen zu den Eigenschaften, die in adaptiven Bereichen verwendet werden sollen, finden Sie unter Konfigurationsinformationen für adaptive Bereiche.

Um dieses Cmdlet in PowerShell für Sicherheitskonformität & verwenden zu können, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

New-AdaptiveScope -Name "Project X" -LocationType User -FilterConditions @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}

In diesem Beispiel wird ein adaptiver Abfragebereich namens Project X mit den folgenden Details erstellt:

  • Bereich: Benutzer
  • Abfrage: "('Land oder Region' entspricht 'USA' oder 'Kanada') und 'Department' entspricht 'Finance'".

Parameter

-Comment

Der „Comment“-Parameter gibt einen optionalen Kommentar an. Wenn Sie einen Wert angeben, der Leerzeichen enthält, setzen Sie den Wert in Anführungszeichen ("), z. B. "This is an admin note".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-FilterConditions

Der Parameter FilterConditions gibt die Bedingungen an, die in der dynamischen Grenze enthalten sind. Gültige Syntax und Werte hängen vom Wert des LocationType-Parameters ab:

  • Benutzer oder Gruppe: Active Directory-Attribute. Verwenden Sie beispielsweise für die Bedingung "('Country or region' equals 'US' or 'Canada') und 'Department' equals 'Finance'" die folgende Syntax: @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
  • Website: Indizierte benutzerdefinierte Eigenschaften. Verwenden Sie beispielsweise für die Bedingung "'Refinable string 0' equals 'Human Resources'" die folgende Syntax: @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

Sie können diesen Parameter nicht mit dem RawQuery-Parameter verwenden.

Type:PswsHashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-LocationType

Der LocationType-Parameter gibt den Speicherort an, an dem der adaptive Bereichsfilter definiert ist. Gültige Werte sind:

  • Benutzer
  • Gruppe (Microsoft 365-Gruppe)
  • Website
Type:DynamicBoundaryLocationType
Accepted values:Unknown, User, Group, Site
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Name

Der Parameter Name gibt einen eindeutigen Namen für den adaptiven Bereich an. Die Höchstlänge beträgt 64 Zeichen. Wenn der Wert Leerzeichen enthält, müssen Sie ihn in Anführungszeichen (") setzen.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RawQuery

Der RawQuery-Parameter wechselt den Bereich in den erweiterten Abfragemodus. Sie verwenden die OPATH-Filtersyntax für den erweiterten Abfragemodus.

Sie können diesen Parameter nicht mit dem Parameter FilterConditions verwenden.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance