Incorporación o desactivación de definiciones de atributos de seguridad personalizados en Microsoft Entra ID

Los atributos de seguridad personalizados de Microsoft Entra ID son atributos específicos de la empresa (pares clave-valor) que puede definir y asignar a objetos de Microsoft Entra. En este artículo se describe cómo agregar, editar o desactivar definiciones de atributos de seguridad personalizados.

Requisitos previos

Para agregar o desactivar definiciones de atributos de seguridad personalizados, debe tener:

• Administrador de definiciones de atributos
• Módulo Microsoft.Graph cuando se usa Microsoft Graph PowerShell
• Versión 2.0.2.138 o posterior de AzureADPreview si usa Azure AD PowerShell

Importante

De forma predeterminada, el rol Administrador global y otros roles de administrador no tienen permisos para leer, definir o asignar atributos de seguridad personalizados.

Agregar un conjunto de atributos

Sugerencia

Los pasos de este artículo pueden variar ligeramente en función del portal desde donde comienza.

Un conjunto de atributos es una colección de atributos relacionados. Todos los atributos de seguridad personalizados deben formar parte de un conjunto de atributos. No se puede cambiar el nombre ni eliminar los conjuntos de atributos.

1. Inicie sesión en el centro de administración de Microsoft Entra como administrador de definición de atributos.

2. Vaya a Protección>Atributos de seguridad personalizados.

3. Haga clic en Agregar conjunto de atributos para agregar un nuevo conjunto de atributos.

   Si la opción Agregar conjunto de atributos está deshabilitada, asegúrese de que se le ha asignado el rol Administrador de definición de atributos. Para más información, consulte Troubleshoot custom security attributes (Solución de problemas de atributos de seguridad personalizados).

4. Escriba un nombre, una descripción y un número máximo de atributos.

   Un nombre de conjunto de atributos puede tener 32 caracteres sin espacios ni caracteres especiales. Una vez que haya especificado un nombre, no puede cambiarlo. Para obtener detalles, consulte Límites y restricciones.

   

5. Cuando haya finalizado, haga clic en Agregar.

   El nuevo conjunto de atributos aparece en la lista de conjuntos de atributos.

Agregar una definición de atributos de seguridad personalizados

1. Inicie sesión en el centro de administración de Microsoft Entra como administrador de definición de atributos.

2. Vaya a Protección>Atributos de seguridad personalizados.

3. En la página Atributos de seguridad personalizados, busque un conjunto de atributos existente o haga clic en Agregar conjunto de atributos para agregar un nuevo conjunto de atributos.

   Todas las definiciones de atributos de seguridad personalizados deben formar parte de un conjunto de atributos.

4. Haga clic para abrir el conjunto de atributos seleccionado.

5. Haga clic en Agregar atributo para agregar un nuevo atributo de seguridad personalizado al conjunto de atributos.

   

6. En el cuadro Nombre del atributo, escriba un nombre de atributo de seguridad personalizado.

   Un nombre de atributo de seguridad personalizado puede tener 32 caracteres sin espacios ni caracteres especiales. Una vez que haya especificado un nombre, no puede cambiarlo. Para obtener detalles, consulte Límites y restricciones.

7. En el cuadro Descripción, escriba una descripción opcional.

   Una descripción puede tener 128 caracteres. Si es necesario, puede cambiar la descripción más adelante.

8. En la lista Tipo de datos, seleccione el tipo de datos para el atributo de seguridad personalizado.

   Tipo de datos	Descripción
   Booleano	Valor booleano que puede ser true, True, false o False.
   Entero	Entero de 32 bits.
   String	Cadena que puede tener una longitud de X caracteres.

9. En Permitir que se asignen varios valores, seleccione Sí o No.

   Seleccione Sí para permitir que se asignen varios valores a este atributo de seguridad personalizado. Seleccione No para permitir que solo se asigne un valor a este atributo de seguridad personalizado.

10. En Permitir que solo se asignen valores predefinidos, seleccione Sí o No.

    Seleccione Sí para requerir que se asignen valores de una lista de valores predefinidos a este atributo de seguridad personalizado. Seleccione No para permitir que a este atributo de seguridad personalizado se le asignen valores definidos por el usuario o valores potencialmente predefinidos.

11. Si Permitir que solo se asignen valores predefinidos está en Sí, haga clic en Agregar valor para agregar valores predefinidos.

    Hay un valor activo disponible para la asignación a objetos. Se define un valor que no está activo, pero aún no está disponible para la asignación.

    

12. Cuando termine, haga clic en Guardar.

    El nuevo atributo de seguridad personalizado aparece en la lista de atributos de seguridad personalizados.

13. Si desea incluir valores predefinidos, siga los pasos de la sección siguiente.

Edición de una definición de atributos de seguridad personalizados

Tras agregar una nueva definición de atributo de seguridad personalizado, podrá editar algunas de las propiedades. Algunas propiedades son inmutables y no se pueden cambiar.

1. Inicie sesión en el centro de administración de Microsoft Entra como administrador de definición de atributos.

2. Vaya a Protección>Atributos de seguridad personalizados.

3. Haga clic en el conjunto de atributos que incluye el atributo de seguridad personalizado que desea editar.

4. En la lista de atributos de seguridad personalizados, haga clic en los puntos suspensivos del atributo de seguridad personalizado que desea editar y, a continuación, seleccione Editar atributo.

5. Edite las propiedades que están habilitadas.

6. Si Permitir que solo se asignen valores predefinidos está en Sí, haga clic en Agregar valor para agregar valores predefinidos. Haga clic en un valor predefinido existente para cambiar la configuración ¿Está activo?.

   

Desactivar una definición de atributos de seguridad personalizados

Una vez que agregue una definición de atributo de seguridad personalizado, no podrá eliminarlo. Sin embargo, puede desactivar una definición de atributo de seguridad personalizado.

1. Inicie sesión en el centro de administración de Microsoft Entra como administrador de definición de atributos.

2. Vaya a Protección>Atributos de seguridad personalizados.

3. Haga clic en el conjunto de atributos que incluye el atributo de seguridad personalizado que desea desactivar.

4. En la lista de atributos de seguridad personalizados, agregue una marca de verificación junto al atributo de seguridad personalizado que desea desactivar.

5. Haga clic en Desactivar atributo.

6. En el cuadro de diálogo Desactivar atributo que aparece, haga clic en Sí.

   El atributo de seguridad personalizado se desactiva y se mueve a la lista Atributos desactivados.

PowerShell o Microsoft Graph API

Para administrar las definiciones de atributos de seguridad personalizados de la organización de Microsoft Entra, puede usar PowerShell o Microsoft Graph API. En los ejemplos siguientes se administran conjuntos de atributos y definiciones de atributos de seguridad personalizados.

Obtener todos los conjuntos de atributos

En el ejemplo siguiente se obtienen todos los conjuntos de atributos.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {}

Description          : Attributes for marketing team
Id                   : Marketing
MaxAttributesPerSet  : 25
AdditionalProperties : {}

Microsoft Graph

List attributeSets

GET https://graph.microsoft.com/v1.0/directory/attributeSets

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

Obtener los conjuntos de atributos principales

En el ejemplo siguiente se obtienen los conjuntos de atributos principales.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Microsoft Graph

List attributeSets

GET https://graph.microsoft.com/v1.0/directory/attributeSets?$top=10

Azure AD PowerShell

None

Obtener los conjuntos de atributos en orden

En el ejemplo siguiente se obtienen los conjuntos de atributos por orden.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Microsoft Graph

List attributeSets

GET https://graph.microsoft.com/v1.0/directory/attributeSets?$orderBy=id

Azure AD PowerShell

None

Obtener un conjunto de atributos

En el ejemplo siguiente se obtiene un conjunto de atributos.

• Conjunto de atributos: Engineering

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -AttributeSetId "Engineering" | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/attributeSets/$entity]}

Microsoft Graph

Get attributeSet

GET https://graph.microsoft.com/v1.0/directory/attributeSets/Engineering

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Agregar un conjunto de atributos

En el ejemplo siguiente se agrega un nuevo conjunto de atributos.

• Conjunto de atributos: Engineering

PowerShell

New-MgDirectoryAttributeSet

$params = @{
    Id = "Engineering"
    Description = "Attributes for engineering team"
    MaxAttributesPerSet = 25
}
New-MgDirectoryAttributeSet -BodyParameter $params

Id          Description                     MaxAttributesPerSet
--          -----------                     -------------------
Engineering Attributes for engineering team 25

Microsoft Graph

Create attributeSet

POST https://graph.microsoft.com/v1.0/directory/attributeSets 
{
    "id":"Engineering",
    "description":"Attributes for engineering team",
    "maxAttributesPerSet":25
}

Azure AD PowerShell

New-AzureADMSAttributeSet

New-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for engineering team" -MaxAttributesPerSet 10 

Actualizar un conjunto de atributos

En el ejemplo siguiente se actualiza un conjunto de atributos.

• Conjunto de atributos: Engineering

PowerShell

Update-MgDirectoryAttributeSet

$params = @{
    description = "Attributes for engineering team"
    maxAttributesPerSet = 20
}
Update-MgDirectoryAttributeSet -AttributeSetId "Engineering" -BodyParameter $params

Microsoft Graph

Update attributeSet

PATCH https://graph.microsoft.com/v1.0/directory/attributeSets/Engineering
{
    "description":"Attributes for engineering team",
    "maxAttributesPerSet":20
}

Azure AD PowerShell

Set-AzureADMSAttributeSet

Set-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for cloud engineering team"
Set-AzureADMSAttributeSet -Id "Engineering" -MaxAttributesPerSet 20

Obtener todas las definiciones de atributos de seguridad personalizados

En el ejemplo siguiente se obtienen todas las definiciones de atributos de seguridad personalizados.

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Marketing
Description             : Country where is application is used
Id                      : Marketing_AppCountry
IsCollection            : True
IsSearchable            : True
Name                    : AppCountry
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Microsoft Graph

List customSecurityAttributeDefinitions

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtrar las definiciones de atributos de seguridad personalizados

En el ejemplo siguiente se filtran las definiciones de atributos de seguridad personalizados.

• Filtro: nombre de atributo eq 'Project' y estado eq 'Available'

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "name eq 'Project' and status eq 'Available'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Microsoft Graph

List customSecurityAttributeDefinitions

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions?$filter=name+eq+'Project'%20and%20status+eq+'Available'

Azure AD PowerShell

None

• Filtro: conjunto de atributos eq 'Engineering' y estado eq 'Available' y tipo de datos eq 'String'

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "attributeSet eq 'Engineering' and status eq 'Available' and type eq 'String'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

Microsoft Graph

List customSecurityAttributeDefinitions

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions?$filter=attributeSet+eq+'Engineering'%20and%20status+eq+'Available'%20and%20type+eq+'String'

Azure AD PowerShell

None

Obtener una definición de atributos de seguridad personalizados

En el ejemplo siguiente se obtiene la definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: ProjectDate

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Microsoft Graph

Get customSecurityAttributeDefinition

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_ProjectDate

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Agregar una definición de atributos de seguridad personalizados

En el ejemplo siguiente se agrega una nueva definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: ProjectDate
• Tipo de datos del atributo: cadena

PowerShell

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Target completion date"
    isCollection = $false
    isSearchable = $true
    name = "ProjectDate"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $false
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Microsoft Graph

Create customSecurityAttributeDefinition

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Target completion date",
    "isCollection":false,
    "isSearchable":true,
    "name":"ProjectDate",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": false
}

Azure AD PowerShell

New-AzureADMSCustomSecurityAttributeDefinition

New-AzureADMSCustomSecurityAttributeDefinition -AttributeSet "Engineering" -Name "ProjectDate" -Description "Target completion date" -Type "String" -Status "Available" -IsCollection $false -IsSearchable $true -UsePreDefinedValuesOnly $false

Agregar una definición de atributo de seguridad personalizado que admita varios valores predefinidos

En el ejemplo siguiente se agrega una nueva definición de atributo de seguridad personalizado que admite varios valores predefinidos.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de datos del atributo: colección de cadenas

PowerShell

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Microsoft Graph

Create customSecurityAttributeDefinition

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Active projects for user",
    "isCollection":true,
    "isSearchable":true,
    "name":"Project",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": true
}

Azure AD PowerShell

None

Agregar una definición de atributo de seguridad personalizado con una lista de valores predefinidos

En el ejemplo siguiente se agrega una nueva definición de atributo de seguridad personalizado con una lista de varios valores predefinidos.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de datos del atributo: colección de cadenas
• Valores predefinidos: Alpine, Baker, Cascade

PowerShell

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
    allowedValues = @(
        @{
            id = "Alpine"
            isActive = $true
        }
        @{
            id = "Baker"
            isActive = $true
        }
        @{
            id = "Cascade"
            isActive = $true
        }
    )
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

Microsoft Graph

Create customSecurityAttributeDefinition

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet": "Engineering",
    "description": "Active projects for user",
    "isCollection": true,
    "isSearchable": true,
    "name": "Project",
    "status": "Available",
    "type": "String",
    "usePreDefinedValuesOnly": true,
    "allowedValues": [
        {
            "id": "Alpine",
            "isActive": true
        },
        {
            "id": "Baker",
            "isActive": true
        },
        {
            "id": "Cascade",
            "isActive": true
        }
    ]
}

Azure AD PowerShell

None

Actualización de una definición de atributo de seguridad personalizado

En el ejemplo siguiente se actualiza la definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: ProjectDate

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    description = "Target completion date (YYYY/MM/DD)"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params

Microsoft Graph

Update customSecurityAttributeDefinition

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_ProjectDate
{
  "description": "Target completion date (YYYY/MM/DD)",
}

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate" -Description "Target completion date (YYYY/MM/DD)"

Actualización de los valores predefinidos de una definición de atributo de seguridad personalizado

En el ejemplo siguiente se actualizan los valores predefinidos para una definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de datos del atributo: colección de cadenas
• Actualizar un valor predefinido: Baker
• Nuevo valor predefinido: Skagit

PowerShell

Invoke-MgGraphRequest

Nota

Para esta solicitud, debe agregar el encabezado OData-Version y asignarle el valor 4.01.

$params = @{
    "allowedValues@delta" = @(
        @{
            id = "Baker"
            isActive = $false
        }
        @{
            id = "Skagit"
            isActive = $true
        }
    )
}
$header = @{
    "OData-Version" = 4.01
}
Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project5" -Headers $header -Body $params

Microsoft Graph

Update customSecurityAttributeDefinition

Nota

Para esta solicitud, debe agregar el encabezado OData-Version y asignarle el valor 4.01.

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project
{
    "allowedValues@delta": [
        {
            "id": "Baker",
            "isActive": false
        },
        {
            "id": "Skagit",
            "isActive": true
        }
    ]
}

Azure AD PowerShell

None

Desactivar una definición de atributos de seguridad personalizados

En el ejemplo siguiente se desactiva la definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: Project

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    status = "Deprecated"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params

Microsoft Graph

Update customSecurityAttributeDefinition

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project
{
  "status": "Deprecated"
}

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_Project" -Status "Deprecated"

Obtener todos los valores predefinidos

En el ejemplo siguiente se obtienen todos los valores predefinidos para una definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: Project

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" | Format-List

Id                   : Skagit
IsActive             : True
AdditionalProperties : {}

Id                   : Baker
IsActive             : False
AdditionalProperties : {}

Id                   : Cascade
IsActive             : True
AdditionalProperties : {}

Id                   : Alpine
IsActive             : True
AdditionalProperties : {}

Microsoft Graph

List allowedValues

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Obtener un valor predefinido

En el ejemplo siguiente se obtiene el valor predefinido para una definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: Project
• Valor predefinido: Alpine

PowerShell

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

Microsoft Graph

Get allowedValue

GET https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues/Alpine

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" 

Agregar un valor predefinido

En el ejemplo siguiente se agrega el valor predefinido para una definición de atributo de seguridad personalizado.

Puede agregar valores predefinidos para atributos de seguridad personalizados que tengan usePreDefinedValuesOnly establecido en true.

• Conjunto de atributos: Engineering
• Atributo: Project
• Valor predefinido: Alpine

PowerShell

New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

$params = @{
    id = "Alpine"
    isActive = $true
}
New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -BodyParameter $params | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

Microsoft Graph

Create allowedValue

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues
{
    "id":"Alpine",
    "isActive":"true"
}

Azure AD PowerShell

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $true

Desactivar un valor predefinido

En el ejemplo siguiente se desactiva el valor predefinido para una definición de atributo de seguridad personalizado.

• Conjunto de atributos: Engineering
• Atributo: Project
• Valor predefinido: Alpine

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

$params = @{
    isActive = $false
}
Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" -BodyParameter $params

Microsoft Graph

Update allowedValue

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues/Alpine
{
    "isActive":"false"
}

Azure AD PowerShell

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $false

Preguntas más frecuentes

¿Se pueden eliminar definiciones de atributos de seguridad personalizados?

No, no puede eliminar definiciones de atributos de seguridad personalizados. Solo puede desactivar definiciones de atributos de seguridad personalizados. Una vez que se desactiva un atributo de seguridad personalizado, ya no se puede aplicar a los objetos de Microsoft Entra. Las asignaciones de atributos de seguridad personalizados de la definición del atributo de seguridad personalizado que se ha desactivado no se quitan automáticamente. No hay ningún límite en el número de atributos de seguridad personalizados desactivados. Puede tener 500 definiciones de atributos de seguridad personalizados activas por inquilino con 100 valores predefinidos permitidos por definición de atributo de seguridad personalizado.

Pasos siguientes

• Administración de acceso a atributos de seguridad personalizados en Microsoft Entra ID
• Asignar, actualizar, enumerar o quitar atributos de seguridad personalizados para un usuario
• Asignación, actualización, enumeración o eliminación de atributos de seguridad personalizados de una aplicación