Set-OrganizationSegment

Módulo:
Exchange PowerShell

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

Use el cmdlet Set-OrganizationSegment para modificar los segmentos de organización en el portal de cumplimiento Microsoft Purview. Los segmentos de organización no entrarán en vigor hasta que aplique las 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.

Sintaxis

Default (valor predeterminado) 

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

Description

Los segmentos se definen mediante el uso de determinados atributos en Microsoft Entra ID.

Para usar este cmdlet en Security & Compliance PowerShell, 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, hemos actualizado el nombre del departamento a "HRDept".

Parámetros

-Identity

Aplicable: Seguridad & cumplimiento

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

  • Nombre
  • Nombre completo (DN)
  • GUID

Propiedades de parámetro

Tipo:PolicyIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UserGroupFilter

Aplicable: Seguridad & cumplimiento

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

  • Incluya todo el filtro OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, $true, , $falseo $null), use las 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, consulte Atributos para las políticas de barrera de información.
  • ComparisonOperator es un operador de comparación OPATH (por ejemplo -eq , para la comparación 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.
  • El valor es el valor de propiedad que se va a buscar. Escriba los valores de texto y las 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 escriba enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $false, o $null , en su lugar).

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.