Partager via

Set-OrganizationSegment

Module:
Exchange PowerShell

Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.

Utilisez l’applet de commande Set-OrganizationSegment pour modifier les segments organization dans le portail de conformité Microsoft Purview. Les segments d’organisation ne sont pas en vigueur tant que vous n’avez pas appliqué des stratégies de barrière à l’information.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

Default (Par défaut) 

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

Description

Les segments sont définis à l’aide de certains attributs dans Microsoft Entra ID.

Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.

Exemples

Exemple 1

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

Dans cet exemple, pour le segment qui a le GUID c96e0837-c232-4a8a-841e-ef45787d8fcd, nous avons mis à jour le nom du service en « HRDept ».

Paramètres

-Identity

Applicable : Sécurité & Conformité

Le paramètre Identity spécifie le segment organization que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie le segment de manière unique. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Propriétés du paramètre

Type:PolicyIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserGroupFilter

Applicable : Sécurité & Conformité

Le paramètre UserGroupFilter utilise la syntaxe de filtre OPATH pour spécifier les membres du segment organization. La syntaxe est "Property -ComparisonOperator 'Value'" (par exemple, "MemberOf -eq 'Engineering Department'" ou "ExtensionAttribute1 -eq 'DayTrader'").

  • Placez l’ensemble du filtre OPATH entre guillemets doubles « ». Si le filtre contient des valeurs système (par exemple, $true, $falseou $null), utilisez plutôt des guillemets simples « ». Bien que ce paramètre soit une chaîne (et non un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
  • Property est une propriété filtrable. Pour plus d’informations, consultez Attributs des stratégies de barrière à l’information.
  • ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq , pour des valeurs égales et -like pour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
  • Value est la valeur de propriété à rechercher. Placez les valeurs de texte et les variables entre guillemets simples ('Value' ou '$Variable'). Si une valeur de variable contient des guillemets simples, vous devez identifier (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez 500, $true, $falseou $null à la place).

Utilisez la même propriété pour tous vos segments et vérifiez que vos segments ne se chevauchent pas (un utilisateur ne doit être affecté qu’à un seul segment).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.