New-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 New-OrganizationSegment pour créer organization segments à utiliser avec les stratégies de barrière de l’information dans le portail de conformité Microsoft Purview. Les segments d’organisation ne sont pas en vigueur tant que vous n’avez pas appliqué les stratégies de barrière de 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) 

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

Description

Pour plus d’informations sur les attributs filtrables que vous pouvez utiliser pour définir des segments, consultez Attributs pour les stratégies de barrière de l’information.

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

New-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"

Dans cet exemple, un segment appelé RH est défini à l’aide de RH, une valeur de l’attribut Department.

Exemple 2

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

Dans cet exemple, nous avons défini un segment appelé NotSales qui inclut toutes les personnes qui ne sont pas dans les ventes. La partie « -ne » de l’applet de commande fait référence à « n’est pas égal à ».

Exemple 3

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

Dans cet exemple, nous avons défini un segment appelé LocalFTE qui inclut les personnes qui sont localisées et dont les postes ne sont pas répertoriés comme temporaires.

Paramètres

-Confirm

Applicable : sécurité & conformité

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

Propriétés du paramètre

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

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

-Name

Applicable : sécurité & conformité

Le paramètre Nom spécifie le nom unique du segment d’organisation. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

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:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
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 d’organisation. La syntaxe est "Property -ComparisonOperator 'Value'" (par exemple, "MemberOf -eq 'Engineering Department'" ou "ExtensionAttribute1 -eq 'DayTrader'").

  • Encadrez 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 (pas un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
  • La propriété est une propriété filtrable. Pour plus d’informations, consultez Attributs pour les stratégies d’interruption de l’information.
  • ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq , pour les égaux et -like pour les chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
  • La valeur est la valeur de la propriété à rechercher. Placer 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 les guillemets simples (échappement) pour développer correctement la variable. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas d’entiers ou de valeurs système entre guillemets (par exemple, utilisez 500, $true, $falseou $null à la place).

Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.

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:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : sécurité & conformité

Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.

Propriétés du paramètre

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

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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.