New-EntraBetaCustomSecurityAttributeDefinition

Módulo:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

Cree un nuevo objeto customSecurityAttributeDefinition.

Sintaxis

Default (valor predeterminado) 

New-EntraBetaCustomSecurityAttributeDefinition

    -IsSearchable <Boolean>
    -IsCollection <Boolean>
    -AttributeSet <String>
    -Type <String>
    -Name <String>
    -Status <String>
    -UsePreDefinedValuesOnly <Boolean>
    [-Description <String>]
    [<CommonParameters>]

Description

El New-EntraBetaCustomSecurityAttributeDefinition cmdlet crea un nuevo objeto customSecurityAttributeDefinition. Especifique IsSearchablelos parámetros , IsCollection, AttributeSetType, Name, Status y UsePreDefinedValuesOnly para crear una nueva definición de atributo de seguridad personalizada.

Puede definir hasta 500 objetos activos en un inquilino.

Al usuario que ha iniciado sesión se le debe asignar uno de los siguientes roles de directorio:

  • Administrador de definiciones de atributos

Ejemplos

Ejemplo 1: Agregar un atributo de seguridad personalizado

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeSet = Get-EntraAttributeSet -Id 'ContosoSet'
$params = @{
    Name                    = 'ProjectTest'
    Description             = 'Target completion'
    Type                    = 'String'
    Status                  = 'Available'
    AttributeSet            = $attributeSet.Id
    IsCollection            = $False
    IsSearchable            = $True
    UsePreDefinedValuesOnly = $True
}
New-EntraBetaCustomSecurityAttributeDefinition @params

Id               AttributeSet Description       IsCollection IsSearchable Name        Status    Type   UsePreDefinedValuesOnly
--               ------------ -----------       ------------ ------------ ----        ------    ----   -----------------------
Test_ProjectTest Test         Target completion False        True         ProjectTest Available String False

En este ejemplo se muestra cómo agregar un atributo de seguridad personalizado.

  • -Name parameter especifica el nombre del atributo de seguridad personalizado.
  • -Description el parámetro especifica la descripción del atributo de seguridad personalizado.
  • -Type parameter especifica el tipo de datos para los valores de atributo de seguridad personalizados.
  • -Status el parámetro especifica que el atributo de seguridad personalizado está activo o desactivado.
  • -AttributeSet parameter especifica el nombre del conjunto de atributos.
  • -IsCollection el parámetro especifica que permite que se puedan asignar varios valores al atributo de seguridad personalizado.
  • -IsSearchable parameter especifica que los valores de atributo de seguridad personalizados se indexan para buscar objetos.
  • -UsePreDefinedValuesOnly parameter especifica los únicos valores predefinidos que se pueden asignar al atributo de seguridad personalizado.

Parámetros

-AttributeSet

Nombre del conjunto de atributos. No distingue mayúsculas de minúsculas.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-Description

Descripción del atributo de seguridad personalizado, hasta 128 caracteres de longitud e inclusión de caracteres Unicode. Esta descripción se puede cambiar más adelante.

Propiedades de parámetro

Tipo:System.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

-IsCollection

Indica si se pueden asignar varios valores al atributo de seguridad personalizado. No se puede cambiar más adelante. Si el tipo se establece en Boolean, isCollection no se puede establecer en true.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

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

-IsSearchable

Indica si los valores de atributos de seguridad personalizados se indizan para buscar en objetos a los que se asignan valores de atributo. No se puede cambiar más adelante.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

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

-Name

Nombre del atributo de seguridad personalizado. Debe ser único dentro de un conjunto de atributos. Puede tener hasta 32 caracteres e incluir caracteres Unicode. No puede contener espacios ni caracteres especiales. No se puede cambiar más adelante. No distingue mayúsculas de minúsculas.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-Status

Especifica si el atributo de seguridad personalizado está activo o desactivado. Los valores aceptables son: Disponible y en desuso. Se puede cambiar más adelante.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-Type

Tipo de datos para los valores de atributo de seguridad personalizados. Los tipos admitidos son: Boolean, Integer y String. No se puede cambiar más adelante.

Propiedades de parámetro

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

Conjuntos de parámetros

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

-UsePreDefinedValuesOnly

Indica si solo se pueden asignar valores predefinidos al atributo de seguridad personalizado. Si se establece en false, se permiten valores de forma libre. Más adelante se puede cambiar de true a false, pero no se puede cambiar de false a true. Si type está establecido en Boolean, usePreDefinedValuesOnly no se puede establecer en true.

Propiedades de parámetro

Tipo:System.Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
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 obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

System.Object