New-OrganizationSegment

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.

Verwenden Sie das New-OrganizationSegment Cmdlet, um organization Segmente für die Verwendung mit Richtlinien für Informationsbarrieren im Microsoft Purview-Complianceportal zu erstellen. Organisationssegmente werden erst wirksam, wenn Sie Richtlinien für Informationsbarrieren anwenden.

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

Syntax

Default (Standard) 

New-OrganizationSegment
    [-Name] <String>
    -UserGroupFilter <String>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Weitere Informationen zu den filterbaren Attributen, die Sie zum Definieren von Segmenten verwenden können, finden Sie unter Attribute für Richtlinien für Informationsbarrieren.

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-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"

In diesem Beispiel wird ein Segment namens "Personalwesen" mithilfe von "Personalwesen" definiert, einem Wert im Attribut "Abteilung".

Beispiel 2

New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"

In diesem Beispiel haben wir ein Segment namens NotSales definiert, das alle Personen enthält, die nicht im Vertrieb tätig sind. Der "-ne"-Teil des Cmdlets bezieht sich auf "ungleich".

Beispiel 3

New-OrganizationSegment -Name "LocalFTE" -UserGroupFilter "Location -eq 'Local' -and Position -ne 'Temporary'"

In diesem Beispiel haben wir ein Segment namens LocalFTE definiert, das Personen umfasst, die sich lokal befinden und deren Positionen nicht als temporär aufgeführt sind.

Parameter

-Confirm

Anwendbar: Sicherheit & Compliance

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

  • 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

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

-Name

Anwendbar: Sicherheit & Compliance

Der Name-Parameter gibt den eindeutigen Namen für das Segment der organization 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:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserGroupFilter

Anwendbar: Sicherheit & Compliance

Der Parameter UserGroupFilter verwendet die OPATH-Filtersyntax, um die Mitglieder des organization-Segments anzugeben. Die Syntax lautet "Property -ComparisonOperator 'Value'" (zum Beispiel "MemberOf -eq 'Engineering Department'" oder "ExtensionAttribute1 -eq 'DayTrader'").

  • 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.
  • Eigenschaft ist eine filterbare Eigenschaft. Weitere Informationen finden Sie unter Attribute für Richtlinien für Informationsbarrieren.
  • ComparisonOperator ist ein OPATH-Vergleichsoperator (z. B -eq . für Gleichheits- und -like 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).

Ausführliche Informationen zu OPATH-Filtern in Exchange finden Sie unter Zusätzliche Informationen zur OPATH-Syntax.

Verwenden Sie dieselbe Eigenschaft für alle Segmente, und stellen Sie sicher, dass sich Ihre Segmente nicht überlappen (ein Benutzer muss nur einem Segment zugewiesen sein).

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

-WhatIf

Anwendbar: Sicherheit & Compliance

Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.

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.