Adicionar ou desativar definições de atributos de segurança personalizados no Microsoft Entra ID

Os atributos de segurança personalizados no Microsoft Entra ID são atributos específicos do negócio (pares chave-valor) que você pode definir e atribuir aos objetos do Microsoft Entra. Este artigo descreve como adicionar, editar ou desativar definições de atributos de segurança personalizados.

Pré-requisitos

Para adicionar ou desativar definições de atributos de segurança personalizados, você deve ter:

• Administrador de Definição de Atributo
• Módulo Microsoft.Graph ao usar o Microsoft Graph PowerShell
• AzureADPreview versão 2.0.2.138 ou posterior ao usar o Azure AD PowerShell

Importante

Por padrão, o Administrador Global e outras funções de administrador não têm permissões para ler, definir ou atribuir atributos de segurança personalizados.

Adicionar um conjunto de atributos

Gorjeta

As etapas neste artigo podem variar ligeiramente com base no portal a partir do qual você começou.

Um conjunto de atributos é uma coleção de atributos relacionados. Todos os atributos de segurança personalizados devem fazer parte de um conjunto de atributos. Os conjuntos de atributos não podem ser renomeados ou excluídos.

1. Entre no centro de administração do Microsoft Entra como um Administrador de Definição de Atributo.

2. Navegue até Atributos de segurança personalizados de proteção>.

3. Clique em Adicionar conjunto de atributos para adicionar um novo conjunto de atributos.

   Se Adicionar conjunto de atributos estiver desativado, certifique-se de que lhe foi atribuída a função de Administrador de Definição de Atributo. Para obter mais informações, consulte Solucionar problemas de atributos de segurança personalizados.

4. Insira um nome, uma descrição e o número máximo de atributos.

   Um nome de conjunto de atributos pode ter 32 caracteres sem espaços ou caracteres especiais. Depois de especificar um nome, não é possível renomeá-lo. Para obter mais informações, consulte Limites e restrições.

   

5. Quando terminar, clique em Adicionar.

   O novo conjunto de atributos aparece na lista de conjuntos de atributos.

Adicionar uma definição de atributo de segurança personalizada

1. Entre no centro de administração do Microsoft Entra como um Administrador de Definição de Atributo.

2. Navegue até Atributos de segurança personalizados de proteção>.

3. Na página Atributos de segurança personalizados, localize um conjunto de atributos existente ou clique em Adicionar conjunto de atributos para adicionar um novo conjunto de atributos.

   Todas as definições de atributos de segurança personalizados devem fazer parte de um conjunto de atributos.

4. Clique para abrir o conjunto de atributos selecionado.

5. Clique em Adicionar atributo para adicionar um novo atributo de segurança personalizado ao conjunto de atributos.

   

6. Na caixa Nome do atributo , insira um nome de atributo de segurança personalizado.

   Um nome de atributo de segurança personalizado pode ter 32 caracteres sem espaços ou caracteres especiais. Depois de especificar um nome, não é possível renomeá-lo. Para obter mais informações, consulte Limites e restrições.

7. Na caixa Descrição, insira uma descrição opcional.

   Uma descrição pode ter 128 caracteres. Se necessário, pode alterar posteriormente a descrição.

8. Na lista Tipo de dados, selecione o tipo de dados para o atributo de segurança personalizado.

   Tipo de dados	Description
   Booleano	Um valor booleano que pode ser true, True, false ou False.
   Número inteiro	Um inteiro de 32 bits.
   String	Uma cadeia de caracteres que pode ter X caracteres.

9. Em Permitir a atribuição de vários valores, selecione Sim ou Não.

   Selecione Sim para permitir que vários valores sejam atribuídos a esse atributo de segurança personalizado. Selecione Não para permitir que apenas um único valor seja atribuído a este atributo de segurança personalizado.

10. Em Permitir apenas que valores predefinidos sejam atribuídos, selecione Sim ou Não.

    Selecione Sim para exigir que este atributo de segurança personalizado receba valores de uma lista de valores predefinida. Selecione Não para permitir que este atributo de segurança personalizado receba valores definidos pelo usuário ou valores potencialmente predefinidos.

11. Se Somente permitir que valores predefinidos sejam atribuídos for Sim, clique em Adicionar valor para adicionar valores predefinidos.

    Um valor ativo está disponível para atribuição a objetos. Um valor que não está ativo está definido, mas ainda não está disponível para atribuição.

    

12. Quando terminar, clique em Guardar.

    O novo atributo de segurança personalizado aparece na lista de atributos de segurança personalizados.

13. Se você quiser incluir valores predefinidos, siga as etapas na próxima seção.

Editar uma definição de atributo de segurança personalizada

Depois de adicionar uma nova definição de atributo de segurança personalizada, você poderá editar posteriormente algumas das propriedades. Algumas propriedades são imutáveis e não podem ser alteradas.

1. Entre no centro de administração do Microsoft Entra como um Administrador de Definição de Atributo.

2. Navegue até Atributos de segurança personalizados de proteção>.

3. Clique no conjunto de atributos que inclui o atributo de segurança personalizado que você deseja editar.

4. Na lista de atributos de segurança personalizados, clique nas reticências do atributo de segurança personalizado que pretende editar e, em seguida, selecione Editar atributo.

5. Edite as propriedades que estão habilitadas.

6. Se Somente permitir que valores predefinidos sejam atribuídos for Sim, clique em Adicionar valor para adicionar valores predefinidos. Clique em um valor predefinido existente para alterar a configuração Está ativo? .

   

Desativar uma definição de atributo de segurança personalizada

Depois de adicionar uma definição de atributo de segurança personalizada, não é possível excluí-la. No entanto, você pode desativar uma definição de atributo de segurança personalizada.

1. Entre no centro de administração do Microsoft Entra como um Administrador de Definição de Atributo.

2. Navegue até Atributos de segurança personalizados de proteção>.

3. Clique no conjunto de atributos que inclui o atributo de segurança personalizado que você deseja desativar.

4. Na lista de atributos de segurança personalizados, adicione uma marca de seleção ao lado do atributo de segurança personalizado que você deseja desativar.

5. Clique em Desativar atributo.

6. Na caixa de diálogo Desativar atributo exibida, clique em Sim.

   O atributo de segurança personalizado é desativado e movido para a lista de atributos desativados.

PowerShell ou API do Microsoft Graph

Para gerenciar definições personalizadas de atributos de segurança em sua organização do Microsoft Entra, você também pode usar o PowerShell ou a API do Microsoft Graph. Os exemplos a seguir gerenciam conjuntos de atributos e definições de atributos de segurança personalizados.

Obter todos os conjuntos de atributos

O exemplo a seguir obtém todos os 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

Listar attributeSets

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

Obter os principais conjuntos de atributos

O exemplo a seguir obtém os principais conjuntos de atributos.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Microsoft Graph

Listar attributeSets

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

Azure AD PowerShell

Nenhuma

Obter conjuntos de atributos em ordem

O exemplo a seguir obtém conjuntos de atributos em ordem.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Microsoft Graph

Listar attributeSets

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

Azure AD PowerShell

Nenhuma

Obter um conjunto de atributos

O exemplo a seguir obtém um 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

Obter attributeSet

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Adicionar um conjunto de atributos

O exemplo a seguir adiciona um novo 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

Criar 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 

Atualizar um conjunto de atributos

O exemplo a seguir atualiza um 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

Atualizar 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

Obter todas as definições de atributos de segurança personalizados

O exemplo a seguir obtém todas as definições de atributo de segurança personalizadas.

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

Listar customSecurityAttributeDefinitions

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtrar definições de atributos de segurança personalizados

Os exemplos a seguir filtram definições de atributos de segurança personalizados.

• Filtrar: Nome do atributo eq 'Projeto' e status eq 'Disponível'

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

Listar customSecurityAttributeDefinitions

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

Azure AD PowerShell

Nenhuma

• Filtrar: Atributo conjunto eq 'Engenharia' e status eq 'Disponível' e tipo de dados 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

Listar 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

Nenhuma

Obter uma definição de atributo de segurança personalizada

O exemplo a seguir obtém uma definição de atributo de segurança personalizada.

• 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

Obter customSecurityAttributeDefinition

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Adicionar uma definição de atributo de segurança personalizada

O exemplo a seguir adiciona uma nova definição de atributo de segurança personalizado.

• Conjunto de atributos: Engineering
• Atributo: ProjectDate
• Tipo de dados do atributo: String

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

Criar 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

Adicionar uma definição de atributo de segurança personalizada que ofereça suporte a vários valores predefinidos

O exemplo a seguir adiciona uma nova definição de atributo de segurança personalizada que oferece suporte a vários valores predefinidos.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de dados de atributo: Coleção de cadeias de caracteres

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

Criar 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

Nenhuma

Adicionar uma definição de atributo de segurança personalizada com uma lista de valores predefinidos

O exemplo a seguir adiciona uma nova definição de atributo de segurança personalizada com uma lista de valores predefinidos.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de dados de atributo: Coleção de cadeias de caracteres
• 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

Criar 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

Nenhuma

Atualizar uma definição de atributo de segurança personalizada

O exemplo a seguir atualiza uma definição de atributo de segurança personalizada.

• 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

Atualizar 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)"

Atualizar os valores predefinidos para uma definição de atributo de segurança personalizada

O exemplo a seguir atualiza os valores predefinidos para uma definição de atributo de segurança personalizada.

• Conjunto de atributos: Engineering
• Atributo: Project
• Tipo de dados de atributo: Coleção de cadeias de caracteres
• Atualizar valor predefinido: Baker
• Novo valor predefinido: Skagit

PowerShell

Invoke-MgGraphRequest

Nota

Para essa solicitação, você deve adicionar o cabeçalho OData-Version e atribuir-lhe o 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

Atualizar customSecurityAttributeDefinition

Nota

Para essa solicitação, você deve adicionar o cabeçalho OData-Version e atribuir-lhe o 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

Nenhuma

Desativar uma definição de atributo de segurança personalizada

O exemplo a seguir desativa uma definição de atributo de segurança personalizada.

• Conjunto de atributos: Engineering
• Atributo: Project

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

Atualizar 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"

Obter todos os valores predefinidos

O exemplo a seguir obtém todos os valores predefinidos para uma definição de atributo de segurança personalizada.

• 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

Lista de valores permitidos

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Obter um valor predefinido

O exemplo a seguir obtém um valor predefinido para uma definição de atributo de segurança personalizada.

• 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

Obter 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" 

Adicionar um valor predefinido

O exemplo a seguir adiciona um valor predefinido para uma definição de atributo de segurança personalizada.

Você pode adicionar valores predefinidos para atributos de segurança personalizados que foram usePreDefinedValuesOnly definidos como 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

Criar 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

Desativar um valor predefinido

O exemplo a seguir desativa um valor predefinido para uma definição de atributo de segurança personalizada.

• 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

Atualizar permitidoValor

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

Perguntas mais frequentes

É possível excluir definições de atributos de segurança personalizados?

Não, não é possível excluir definições de atributos de segurança personalizados. Você só pode desativar definições de atributos de segurança personalizados. Depois de desativar um atributo de segurança personalizado, ele não pode mais ser aplicado aos objetos do Microsoft Entra. As atribuições de atributos de segurança personalizados para a definição de atributo de segurança personalizada desativada não são removidas automaticamente. Não há limite para o número de atributos de segurança personalizados desativados. Você pode ter 500 definições de atributo de segurança personalizado ativo por locatário com 100 valores predefinidos permitidos por definição de atributo de segurança personalizado.

Próximos passos

• Gerenciar o acesso a atributos de segurança personalizados no Microsoft Entra ID
• Atribuir, atualizar, listar ou remover atributos de segurança personalizados para um usuário
• Atribuir, atualizar, listar ou remover atributos de segurança personalizados para um aplicativo