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 New-AdaptiveScope Cmdlet, 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' ist gleich 'USA' oder 'Kanada') und 'Department' ist gleich 'Finanzen'".
Parameter
-AdministrativeUnit
Anwendbar: Sicherheit & 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: Sicherheit & 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: Sicherheit & 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 zum Beispiel für die Bedingung "('Land oder Region' ist gleich 'USA' oder 'Kanada') und 'Abteilung' ist gleich 'Finanzen'" 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 "'Eingeschränkte Zeichenfolge 0' ist gleich 'Personalwesen'" 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: Sicherheit & Compliance
Der Parameter LocationType gibt den Speicherort an, an dem der Filter für den adaptiven Bereich 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: Sicherheit & Compliance
Der Name-Parameter 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: Sicherheit & Compliance
Der Parameter RawQuery schaltet 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.