Set-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 Set-OrganizationSegment Cmdlet, um organization Segmente in der Microsoft Purview-Complianceportal zu ändern. 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) 

Set-OrganizationSegment
    [-Identity] <PolicyIdParameter>
    [-UserGroupFilter <String>]
    [<CommonParameters>]

Beschreibung

Segmente werden mithilfe bestimmter Attribute in Microsoft Entra ID definiert.

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

Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"

In diesem Beispiel wurde für das Segment mit der GUID c96e0837-c232-4a8a-841e-ef45787d8fcd der Abteilungsname auf "HRDept" aktualisiert.

Parameter

-Identity

Anwendbar: Sicherheit & Compliance

Der Parameter "Identity" gibt das Segment der organization an, das Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der das Segment eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

Parametereigenschaften

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

Parametersätze

(All)
Position:0
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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).

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