Set-OrganizationSegment

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Security & Compliance

Este cmdlet solo está disponible en PowerShell de cumplimiento de seguridad & . Para obtener más información, consulte Security & Compliance PowerShell.

Use el cmdlet Set-OrganizationSegment para modificar los segmentos de la organización en el portal de cumplimiento Microsoft Purview. Los segmentos de la organización no están en vigor hasta que se aplican directivas de barrera de información.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Los segmentos se definen mediante ciertos atributos en Azure Active Directory.

Para usar este cmdlet en PowerShell de cumplimiento de seguridad & , debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.

Ejemplos

Ejemplo 1

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

En este ejemplo, para el segmento que tiene el GUID c96e0837-c232-4a8a-841e-ef45787d8fcd, actualizamos el nombre del departamento a "HRDept".

Parámetros

-Identity

El parámetro Identity especifica el segmento de la organización que desea modificar. Puede usar cualquier valor que identifique de forma única el segmento. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:PolicyIdParameter
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-UserGroupFilter

El parámetro UserGroupFilter usa la sintaxis de filtro de OPATH para especificar los miembros del segmento de la organización. La sintaxis es "Property -ComparisonOperator 'Value'" (por ejemplo, "MemberOf -eq 'Engineering Department'" o "ExtensionAttribute1 -eq 'DayTrader'").

  • Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.
  • La propiedad es una propiedad filtrable. Para obtener más información, vea Atributos para directivas de barrera de información.
  • ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
  • Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).

Use la misma propiedad para todos los segmentos y compruebe que los segmentos no se superponen (un usuario debe estar asignado a un solo segmento).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance