Adicionar ou desativar definições de atributo de segurança personalizadas na ID do Microsoft Entra

Atributos de segurança personalizados na ID do Microsoft Entra são atributos específicos para os negócios (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 atributo de segurança personalizadas.

Pré-requisitos

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

• administrador de definição de atributo
• Módulo do Microsoft.Graph ao usar o PowerShell do Microsoft Graph
• AzureADPreview versão 2.0.2.138 ou posterior ao usar o PowerShell do Azure AD

Importante

Por padrã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

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 renomeado ou excluídos.

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

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

3. Selecione Adicionar conjunto de atributos para adicionar um novo conjunto de atributos.

   Se Adicionar conjunto de atributos estiver desabilitado, verifique se você recebeu a função 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 um 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, você não poderá renomeá-lo. Para obter mais informações, consulte Limites e restrições.

   

5. Quando terminar, selecione 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 Atributos.

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

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

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

4. Selecione para abrir o conjunto de atributos selecionado.

5. Selecione 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, você não poderá 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, você poderá alterar a descrição posteriormente.

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

   Tipo de dados	Descrição
   Booliano	Um valor booliano que pode ser true, true, false ou false.
   Inteiro	Um inteiro de 32 bits.
   String	Uma string que pode ter X caracteres de comprimento.

9. Para Permitir que vários valores sejam atribuídos, selecione Sim ou Não.

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

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

    Selecione Sim para exigir que esse atributo de segurança personalizado seja atribuído a valores de uma lista de valores predefinidos. Selecione Nenhum para permitir que esse atributo de segurança personalizado seja atribuído a valores definidos pelo usuário ou valores potencialmente predefinidos.

11. Se permitir apenas que valores predefinidos sejam atribuídos é Sim, selecione Adicionar valor para adicionar valores predefinidos.

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

    

12. Quando terminar, selecione Salvar.

    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 algumas das propriedades posteriormente. 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 Atributos.

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

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

4. Na lista de atributos de segurança personalizados, selecione as reticências do atributo de segurança personalizado que você deseja editar e selecione Editar atributo.

5. Edite as propriedades que estão habilitadas.

6. Se permitir apenas que valores predefinidos sejam atribuídos é Sim, selecione 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, você não poderá 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 Atributos.

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

3. Selecione o 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. Selecione Desativar atributo.

6. Na caixa de diálogo desativar atributo exibida, selecione Sim.

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

API do PowerShell ou do Microsoft Graph

Para gerenciar definições de atributo de segurança personalizadas 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 atributo de segurança personalizadas.

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 conjuntos de atributos

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

PowerShell do Azure AD

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

List attributeSets

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

PowerShell do Azure AD

Nenhum

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 conjuntos de atributos

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

PowerShell do Azure AD

Nenhum

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 conjunto de atributos

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

PowerShell do Azure AD

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 conjunto de atributos

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

PowerShell do Azure AD

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 conjunto de atributos

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

PowerShell do Azure AD

Set-AzureADMSAttributeSet

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

Obter todas as definições de atributo de segurança personalizadas

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

List customSecurityAttributeDefinitions

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

PowerShell do Azure AD

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtrar definições de atributo de segurança personalizadas

Os exemplos a seguir filtram definições de atributo de segurança personalizadas.

• Filtro: 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

List customSecurityAttributeDefinitions

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

PowerShell do Azure AD

Nenhum

• Filtro: conjunto de atributos igual a 'Engenharia' e status igual a 'Disponível' e tipo de dados igual a '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

Nenhum

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

Get customSecurityAttributeDefinition

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

PowerShell do Azure AD

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 personalizada.

• Conjunto de atributos: Engineering
• Atributo: ProjectDate
• Tipo de dados de atributo: Cadeia de caracteres

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
}

PowerShell do Azure AD

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 dá suporte a vários valores predefinidos

O exemplo a seguir adiciona uma nova definição de atributo de segurança personalizada que dá 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 definição de atributo de segurança personalizado

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

Nenhum

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

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
        }
    ]
}

PowerShell do Azure AD

Nenhum

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

Update customSecurityAttributeDefinition

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

PowerShell do Azure AD

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 atribuí-lo ao 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 essa solicitação, você deve adicionar o cabeçalho OData-Version e atribuí-lo ao valor 4.01.

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

PowerShell do Azure AD

Nenhum

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

Update customSecurityAttributeDefinition

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

PowerShell do Azure AD

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

List allowedValues

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

PowerShell do Azure AD

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

Get allowedValue

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

PowerShell do Azure AD

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 definidos previamente para atributos de segurança personalizados que têm 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

Create allowedValue

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

PowerShell do Azure AD

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

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

Perguntas frequentes

Você pode excluir definições de atributo de segurança personalizadas?

Não, você não pode excluir definições de atributo de segurança personalizadas. Você só pode desativar as definições de atributos de segurança personalizados. Depois de desativar um atributo de segurança personalizado, ele não poderá mais ser aplicado aos objetos do Microsoft Entra. As atribuições de atributo de segurança personalizadas 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 atributos de segurança personalizadas ativas por locatário com 100 valores predefinidos permitidos por definição de atributo de segurança personalizada.

Próximas etapas

• 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