New-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 de New-OrganizationSegment para crear segmentos de organización que se usarán con directivas de barrera de informació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) 

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

Description

Para obtener más información sobre los atributos filtrables que puede utilizar para definir segmentos, consulte Atributos para políticas de barrera de información.

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

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

En este ejemplo, un segmento denominado RR. HH. se define mediante RR. HH., un valor del atributo Departamento.

Ejemplo 2

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

En este ejemplo, hemos definido un segmento llamado NotSales que incluye a todos los usuarios que no están en Ventas. La parte "-ne" del cmdlet hace referencia a "no es igual a".

Ejemplo 3

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

En este ejemplo, definimos un segmento llamado LocalFTE que incluye a las personas que se encuentran localmente y cuyos puestos no figuran como temporales.

Parámetros

-Confirm

Aplicable: Seguridad & cumplimiento

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

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

-Name

Aplicable: Seguridad & cumplimiento

El parámetro Name especifica el nombre único del segmento de organización. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
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).

Para obtener información detallada sobre los filtros OPATH en Exchange, consulte Información adicional de sintaxis de OPATH.

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
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Seguridad & cumplimiento

El modificador WhatIf no funciona en Security & Compliance PowerShell.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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.