Aggiungere o disattivare definizioni di attributi di sicurezza personalizzati in Microsoft Entra ID

Gli attributi di sicurezza personalizzati in Microsoft Entra ID sono attributi specifici dell'azienda (coppie chiave-valore) che è possibile definire e assegnare agli oggetti Microsoft Entra. Questo articolo descrive come aggiungere, modificare o disattivare definizioni di attributi di sicurezza personalizzati.

Prerequisiti

Per aggiungere o disattivare definizioni di attributi di sicurezza personalizzati, è necessario disporre di:

• Definizione dell'attributo Amministrazione istrator
• Modulo Microsoft.Graph quando si usa Microsoft Graph PowerShell
• AzureADPreview versione 2.0.2.138 o successiva quando si usa Azure AD PowerShell

Importante

Per impostazione predefinita, Global Amministrazione istrator e altri ruoli di amministratore non dispongono delle autorizzazioni per leggere, definire o assegnare attributi di sicurezza personalizzati.

Aggiungere un set di attributi

Suggerimento

I passaggi descritti in questo articolo possono variare leggermente in base al portale da cui si inizia.

Un set di attributi è una raccolta di attributi correlati. Tutti gli attributi di sicurezza personalizzati devono far parte di un set di attributi. I set di attributi non possono essere rinominati o eliminati.

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come definizione di attributo Amministrazione istrator.

2. Passare a Protezione>attributi di sicurezza personalizzati.

3. Fare clic su Aggiungi set di attributi per aggiungere un nuovo set di attributi.

   Se Aggiungi set di attributi è disabilitato, assicurarsi di aver assegnato il ruolo Definizione attributo Amministrazione istrator. Per altre informazioni, vedere Risolvere i problemi relativi agli attributi di sicurezza personalizzati.

4. Immettere un nome, una descrizione e un numero massimo di attributi.

   Un nome del set di attributi può essere di 32 caratteri senza spazi o caratteri speciali. Dopo aver specificato un nome, non è possibile rinominarlo. Per altre informazioni, vedere Limiti e vincoli.

   

5. Al termine, fare clic su Aggiungi.

   Il nuovo set di attributi viene visualizzato nell'elenco dei set di attributi.

Aggiungere una definizione di attributo di sicurezza personalizzata

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come definizione di attributo Amministrazione istrator.

2. Passare a Protezione>attributi di sicurezza personalizzati.

3. Nella pagina Attributi di sicurezza personalizzati trovare un set di attributi esistente o fare clic su Aggiungi set di attributi per aggiungere un nuovo set di attributi.

   Tutte le definizioni di attributi di sicurezza personalizzate devono far parte di un set di attributi.

4. Fare clic per aprire il set di attributi selezionato.

5. Fare clic su Aggiungi attributo per aggiungere un nuovo attributo di sicurezza personalizzato al set di attributi.

   

6. Nella casella Nome attributo immettere un nome di attributo di sicurezza personalizzato.

   Un nome di attributo di sicurezza personalizzato può essere di 32 caratteri senza spazi o caratteri speciali. Dopo aver specificato un nome, non è possibile rinominarlo. Per altre informazioni, vedere Limiti e vincoli.

7. Nella casella Descrizione immettere una descrizione facoltativa.

   Una descrizione può contenere una lunghezza di 128 caratteri. Se necessario, è possibile modificare successivamente la descrizione.

8. Nell'elenco Tipo di dati selezionare il tipo di dati per l'attributo di sicurezza personalizzato.

   Tipo di dati	Descrizione
   Boolean	Valore booleano che può essere true, True, false o False.
   Intero	Un valore integer a 32 bit.
   String	Stringa che può essere lunga X caratteri.

9. Per Consenti l'assegnazione di più valori, selezionare Sì o No.

   Selezionare Sì per consentire l'assegnazione di più valori a questo attributo di sicurezza personalizzato. Selezionare No per consentire solo l'assegnazione di un singolo valore a questo attributo di sicurezza personalizzato.

10. Per Consenti solo l'assegnazione di valori predefiniti selezionare Sì o No.

    Selezionare Sì per richiedere che a questo attributo di sicurezza personalizzato vengano assegnati valori da un elenco di valori predefiniti. Selezionare No per consentire a questo attributo di sicurezza personalizzato di assegnare valori definiti dall'utente o valori potenzialmente predefiniti.

11. Se consenti l'assegnazione dei valori predefiniti è Sì, fai clic su Aggiungi valore per aggiungere valori predefiniti.

    Per l'assegnazione a oggetti è disponibile un valore attivo. Viene definito un valore non attivo, ma non ancora disponibile per l'assegnazione.

    

12. Al termine fare clic su Salva.

    Il nuovo attributo di sicurezza personalizzato viene visualizzato nell'elenco degli attributi di sicurezza personalizzati.

13. Se si desidera includere valori predefiniti, seguire la procedura descritta nella sezione successiva.

Modificare una definizione di attributo di sicurezza personalizzata

Dopo aver aggiunto una nuova definizione di attributo di sicurezza personalizzata, è possibile modificare alcune delle proprietà in un secondo momento. Alcune proprietà non sono modificabili e non possono essere modificate.

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come definizione di attributo Amministrazione istrator.

2. Passare a Protezione>attributi di sicurezza personalizzati.

3. Fare clic sul set di attributi che include l'attributo di sicurezza personalizzato che si desidera modificare.

4. Nell'elenco degli attributi di sicurezza personalizzati fare clic sui puntini di sospensione per l'attributo di sicurezza personalizzato che si desidera modificare e quindi selezionare Modifica attributo.

5. Modificare le proprietà abilitate.

6. Se consenti l'assegnazione dei valori predefiniti è Sì, fai clic su Aggiungi valore per aggiungere valori predefiniti. Fare clic su un valore predefinito esistente per modificare l'impostazione È attiva?

   

Disattivare una definizione di attributo di sicurezza personalizzata

Dopo aver aggiunto una definizione di attributo di sicurezza personalizzata, non è possibile eliminarla. Tuttavia, è possibile disattivare una definizione di attributo di sicurezza personalizzata.

1. Accedere all'interfaccia di amministrazione di Microsoft Entra come definizione di attributo Amministrazione istrator.

2. Passare a Protezione>attributi di sicurezza personalizzati.

3. Fare clic sul set di attributi che include l'attributo di sicurezza personalizzato da disattivare.

4. Nell'elenco degli attributi di sicurezza personalizzati aggiungere un segno di spunta accanto all'attributo di sicurezza personalizzato da disattivare.

5. Fare clic su Disattiva attributo.

6. Nella finestra di dialogo Disattiva attributo visualizzata fare clic su Sì.

   L'attributo di sicurezza personalizzato viene disattivato e spostato nell'elenco Attributi disattivati.

PowerShell o l'API Microsoft Graph

Per gestire definizioni di attributi di sicurezza personalizzate nell'organizzazione Microsoft Entra, è anche possibile usare PowerShell o l'API Microsoft Graph. Gli esempi seguenti gestiscono i set di attributi e le definizioni di attributi di sicurezza personalizzati.

Ottenere tutti i set di attributi

Nell'esempio seguente vengono visualizzati tutti i set di attributi.

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

Ottenere i set di attributi principali

L'esempio seguente ottiene i set di attributi principali.

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

Ottenere set di attributi in ordine

L'esempio seguente ottiene i set di attributi in ordine.

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

Ottenere un set di attributi

L'esempio seguente ottiene un set di attributi.

• Set di attributi: 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"

Aggiungere un set di attributi

Nell'esempio seguente viene aggiunto un nuovo set di attributi.

• Set di attributi: 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

Creare 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 

Aggiornare un set di attributi

Nell'esempio seguente viene aggiornato un set di attributi.

• Set di attributi: 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

Ottenere tutte le definizioni degli attributi di sicurezza personalizzati

Nell'esempio seguente vengono recuperate tutte le definizioni di attributi di sicurezza personalizzate.

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

Elencare customSecurityAttributeDefinitions

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtrare le definizioni degli attributi di sicurezza personalizzati

Negli esempi seguenti vengono filtrate le definizioni degli attributi di sicurezza personalizzati.

• Filtro: nome attributo eq 'Project' e status 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

Elencare customSecurityAttributeDefinitions

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

Azure AD PowerShell

None

• Filtro: set di attributi eq 'Engineering' e status eq 'Available' e tipo di dati 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

Elencare 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

Ottenere una definizione di attributo di sicurezza personalizzata

Nell'esempio seguente viene recuperata una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: 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

Ottenere customSecurityAttributeDefinition

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Aggiungere una definizione di attributo di sicurezza personalizzata

Nell'esempio seguente viene aggiunta una nuova definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: ProjectDate
• Tipo di dati attributo: 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

Creare 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

Aggiungere una definizione di attributo di sicurezza personalizzata che supporti più valori predefiniti

Nell'esempio seguente viene aggiunta una nuova definizione di attributo di sicurezza personalizzata che supporta più valori predefiniti.

• Set di attributi: Engineering
• Attributo: Project
• Tipo di dati attributo: raccolta di stringhe

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

Creare 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

Aggiungere una definizione di attributo di sicurezza personalizzata con un elenco di valori predefiniti

Nell'esempio seguente viene aggiunta una nuova definizione di attributo di sicurezza personalizzata con un elenco di valori predefiniti.

• Set di attributi: Engineering
• Attributo: Project
• Tipo di dati attributo: raccolta di stringhe
• Valori predefiniti: 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

Creare 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

Aggiornare una definizione di attributo di sicurezza personalizzata

Nell'esempio seguente viene aggiornata una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: ProjectDate

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

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

Aggiornare i valori predefiniti per una definizione di attributo di sicurezza personalizzata

Nell'esempio seguente vengono aggiornati i valori predefiniti per una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: Project
• Tipo di dati attributo: raccolta di stringhe
• Aggiornare il valore predefinito: Baker
• Nuovo valore predefinito: Skagit

PowerShell

Invoke-MgGraphRequest

Nota

Per questa richiesta, è necessario aggiungere l'intestazione OData-Version e assegnargli il valore 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

Aggiornare customSecurityAttributeDefinition

Nota

Per questa richiesta, è necessario aggiungere l'intestazione OData-Version e assegnargli il valore 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

Disattivare una definizione di attributo di sicurezza personalizzata

Nell'esempio seguente viene disattivata una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: Project

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

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

Ottenere tutti i valori predefiniti

Nell'esempio seguente vengono restituiti tutti i valori predefiniti per una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: 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

Elenco allowedValues

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Ottenere un valore predefinito

Nell'esempio seguente viene restituito un valore predefinito per una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: Project
• Valore predefinito: 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" 

Aggiungere un valore predefinito

Nell'esempio seguente viene aggiunto un valore predefinito per una definizione di attributo di sicurezza personalizzata.

È possibile aggiungere valori predefiniti per gli attributi usePreDefinedValuesOnly di sicurezza personalizzati impostati su true.

• Set di attributi: Engineering
• Attributo: Project
• Valore predefinito: 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

Creare 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

Disattivare un valore predefinito

Nell'esempio seguente viene disattivato un valore predefinito per una definizione di attributo di sicurezza personalizzata.

• Set di attributi: Engineering
• Attributo: Project
• Valore predefinito: Alpine

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

Microsoft Graph

Aggiornare 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

Domande frequenti

È possibile eliminare definizioni di attributi di sicurezza personalizzate?

No, non è possibile eliminare definizioni di attributi di sicurezza personalizzate. È possibile disattivare solo definizioni di attributi di sicurezza personalizzati. Dopo aver disattivato un attributo di sicurezza personalizzato, non può più essere applicato agli oggetti Microsoft Entra. Le assegnazioni di attributi di sicurezza personalizzate per la definizione dell'attributo di sicurezza personalizzato disattivato non vengono rimosse automaticamente. Non esiste alcun limite al numero di attributi di sicurezza personalizzati disattivati. È possibile avere 500 definizioni di attributi di sicurezza personalizzate attive per ogni tenant con 100 valori predefiniti consentiti per ogni definizione di attributo di sicurezza personalizzato.

Passaggi successivi

• Gestire l'accesso agli attributi di sicurezza personalizzati in Microsoft Entra ID
• Assegnare, aggiornare, elencare o rimuovere attributi di sicurezza personalizzati per un utente
• Assegnare, aggiornare, elencare o rimuovere attributi di sicurezza personalizzati per un'applicazione