New-AdaptiveScope
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das Cmdlet New-AdaptiveScope, um adaptive Bereiche in Ihrem organization 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
Default
New-AdaptiveScope
-Name <String>
-FilterConditions <PswsHashtable>
-LocationType <DynamicBoundaryLocationType>
[-AdministrativeUnit <Guid>]
[-Comment <String>]
[<CommonParameters>]
AdaptiveScopeRawQuery
New-AdaptiveScope
-Name <String>
-LocationType <DynamicBoundaryLocationType>
-RawQuery <String>
[-AdministrativeUnit <Guid>]
[-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 Security & Compliance PowerShell zu verwenden, 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
-AdministrativeUnit
Anwendbar: Security & Compliance
{{ Fill AdministrativeUnit Description }}
Parametereigenschaften
| Typ: | Guid |
| 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 |
-Comment
Anwendbar: Security & Compliance
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".
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 |
-FilterConditions
Anwendbar: Security & Compliance
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.
Parametereigenschaften
| Typ: | PswsHashtable |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Default
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LocationType
Anwendbar: Security & Compliance
Der LocationType-Parameter gibt den Speicherort an, an dem der adaptive Bereichsfilter definiert ist. Gültige Werte sind:
- Benutzer
- Gruppe (Microsoft 365-Gruppe)
- Website
Parametereigenschaften
| Typ: | DynamicBoundaryLocationType |
| Standardwert: | None |
| Zulässige Werte: | Unknown, User, Group, Site |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Anwendbar: Security & Compliance
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RawQuery
Anwendbar: Security & Compliance
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
AdaptiveScopeRawQuery
| Position: | Named |
| Obligatorisch.: | True |
| 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.