Lägga till eller inaktivera anpassade säkerhetsattributdefinitioner i Microsoft Entra-ID

Anpassade säkerhetsattribut i Microsoft Entra-ID är affärsspecifika attribut (nyckel/värde-par) som du kan definiera och tilldela till Microsoft Entra-objekt. Den här artikeln beskriver hur du lägger till, redigerar eller inaktiverar definitioner för anpassade säkerhetsattribut.

Förutsättningar

Om du vill lägga till eller inaktivera definitioner för anpassade säkerhetsattribut måste du ha:

• Attributdefinitionsadministratör
• Microsoft.Graph-modul när du använder Microsoft Graph PowerShell
• AzureADPreview version 2.0.2.138 eller senare när du använder Azure AD PowerShell

Viktigt!

Som standard har global administratör och andra administratörsroller inte behörighet att läsa, definiera eller tilldela anpassade säkerhetsattribut.

Lägga till en attributuppsättning

Dricks

Stegen i den här artikeln kan variera något beroende på vilken portal du börjar från.

En attributuppsättning är en samling relaterade attribut. Alla anpassade säkerhetsattribut måste ingå i en attributuppsättning. Det går inte att byta namn på eller ta bort attributuppsättningar.

1. Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.

2. Bläddra till Anpassade säkerhetsattribut för skydd>.

3. Klicka på Lägg till attributuppsättning för att lägga till en ny attributuppsättning.

   Om Lägg till attributuppsättning är inaktiverad kontrollerar du att du har tilldelats rollen Administratör för attributdefinition. Mer information finns i Felsöka anpassade säkerhetsattribut.

4. Ange ett namn, en beskrivning och ett maximalt antal attribut.

   Ett attributuppsättningsnamn kan vara 32 tecken utan blanksteg eller specialtecken. När du har angett ett namn kan du inte byta namn på det. Mer information finns i Gränser och begränsningar.

   

5. När du är klar klickar du på Lägg till.

   Den nya attributuppsättningen visas i listan över attributuppsättningar.

Lägga till en definition för anpassade säkerhetsattribut

1. Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.

2. Bläddra till Anpassade säkerhetsattribut för skydd>.

3. På sidan Anpassade säkerhetsattribut letar du upp en befintlig attributuppsättning eller klickar på Lägg till attributuppsättning för att lägga till en ny attributuppsättning.

   Alla definitioner för anpassade säkerhetsattribut måste ingå i en attributuppsättning.

4. Klicka för att öppna den valda attributuppsättningen.

5. Klicka på Lägg till attribut för att lägga till ett nytt anpassat säkerhetsattribut i attributuppsättningen.

   

6. I rutan Attributnamn anger du ett anpassat säkerhetsattributnamn.

   Ett anpassat säkerhetsattributnamn kan vara 32 tecken utan blanksteg eller specialtecken. När du har angett ett namn kan du inte byta namn på det. Mer information finns i Gränser och begränsningar.

7. I rutan Beskrivning anger du en valfri beskrivning.

   En beskrivning kan vara 128 tecken lång. Om det behövs kan du senare ändra beskrivningen.

8. I listan Datatyp väljer du datatypen för det anpassade säkerhetsattributet.

   Datatyp	beskrivning
   Booleskt	Ett booleskt värde som kan vara sant, Sant, Falskt eller Falskt.
   Integer	Ett 32-bitars heltal.
   String	En sträng som kan vara X-tecken lång.

9. För Tillåt att flera värden tilldelas väljer du Ja eller Nej.

   Välj Ja för att tillåta att flera värden tilldelas till det här anpassade säkerhetsattributet. Välj Nej om du bara vill att ett enda värde ska tilldelas till det här anpassade säkerhetsattributet.

10. För Tillåt endast fördefinierade värden att tilldelas väljer du Ja eller Nej.

    Välj Ja för att kräva att det här anpassade säkerhetsattributet tilldelas värden från en fördefinierad värdelista. Välj Nej för att tillåta att det här anpassade säkerhetsattributet tilldelas användardefinierade värden eller potentiellt fördefinierade värden.

11. Om Endast tillåt att fördefinierade värden tilldelas är Ja klickar du på Lägg till värde för att lägga till fördefinierade värden.

    Ett aktivt värde är tillgängligt för tilldelning till objekt. Ett värde som inte är aktivt definieras, men som ännu inte är tillgängligt för tilldelning.

    

12. När det är klart klickar du på Spara.

    Det nya anpassade säkerhetsattributet visas i listan över anpassade säkerhetsattribut.

13. Om du vill inkludera fördefinierade värden följer du stegen i nästa avsnitt.

Redigera en definition för anpassade säkerhetsattribut

När du har lagt till en ny definition för anpassade säkerhetsattribut kan du senare redigera några av egenskaperna. Vissa egenskaper är oföränderliga och kan inte ändras.

1. Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.

2. Bläddra till Anpassade säkerhetsattribut för skydd>.

3. Klicka på den attributuppsättning som innehåller det anpassade säkerhetsattribut som du vill redigera.

4. I listan över anpassade säkerhetsattribut klickar du på ellipsen för det anpassade säkerhetsattributet som du vill redigera och väljer sedan Redigera attribut.

5. Redigera de egenskaper som är aktiverade.

6. Om Endast tillåt att fördefinierade värden tilldelas är Ja klickar du på Lägg till värde för att lägga till fördefinierade värden. Klicka på ett befintligt fördefinierat värde för att ändra inställningen Är aktiv?

   

Inaktivera en definition för anpassade säkerhetsattribut

När du har lagt till en definition för anpassade säkerhetsattribut kan du inte ta bort den. Du kan dock inaktivera en anpassad definition av säkerhetsattribut.

1. Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.

2. Bläddra till Anpassade säkerhetsattribut för skydd>.

3. Klicka på den attributuppsättning som innehåller det anpassade säkerhetsattributet som du vill inaktivera.

4. I listan över anpassade säkerhetsattribut lägger du till en bockmarkering bredvid det anpassade säkerhetsattribut som du vill inaktivera.

5. Klicka på Inaktivera attribut.

6. I dialogrutan Inaktivera attribut som visas klickar du på Ja.

   Det anpassade säkerhetsattributet inaktiveras och flyttas till listan Inaktiverade attribut.

PowerShell eller Microsoft Graph API

Om du vill hantera anpassade definitioner av säkerhetsattribut i din Microsoft Entra-organisation kan du också använda PowerShell eller Microsoft Graph API. I följande exempel hanteras attributuppsättningar och definitioner av anpassade säkerhetsattribut.

Hämta alla attributuppsättningar

I följande exempel hämtas alla attributuppsättningar.

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

Lista attributUppsättningar

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

Hämta de främsta attributuppsättningarna

I följande exempel hämtas de främsta attributuppsättningarna.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Microsoft Graph

Lista attributUppsättningar

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

Azure AD PowerShell

Ingen

Hämta attributuppsättningar i ordning

I följande exempel hämtas attributuppsättningar i ordning.

PowerShell

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Microsoft Graph

Lista attributUppsättningar

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

Azure AD PowerShell

Ingen

Hämta en attributuppsättning

I följande exempel hämtas en attributuppsättning.

• Attributuppsättning: 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

Hämta attributeSet

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

Azure AD PowerShell

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

Lägga till en attributuppsättning

I följande exempel läggs en ny attributuppsättning till.

• Attributuppsättning: 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

Skapa 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 

Uppdatera en attributuppsättning

I följande exempel uppdateras en attributuppsättning.

• Attributuppsättning: Engineering

PowerShell

Update-MgDirectoryAttributeSet

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

Microsoft Graph

Uppdatera attributUppsättning

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

Hämta alla definitioner för anpassade säkerhetsattribut

I följande exempel hämtas alla definitioner av anpassade säkerhetsattribut.

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

Lista customSecurityAttributeDefinitions

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

Filtrera definitioner för anpassade säkerhetsattribut

I följande exempel filtreras definitioner av anpassade säkerhetsattribut.

• Filter: Attributnamnet eq "Project" och 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

Lista customSecurityAttributeDefinitions

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

Azure AD PowerShell

Ingen

• Filter: Attributuppsättningen eq 'Engineering' och status eq 'Available' och datatypen 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

Lista 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

Ingen

Hämta en definition för anpassade säkerhetsattribut

I följande exempel hämtas en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: 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

Hämta customSecurityAttributeDefinition

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

Lägga till en definition för anpassade säkerhetsattribut

I följande exempel läggs en ny definition av anpassade säkerhetsattribut till.

• Attributuppsättning: Engineering
• Attributet: ProjectDate
• Attributdatatyp: Sträng

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

Skapa 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

Lägg till en anpassad definition av säkerhetsattribut som stöder flera fördefinierade värden

I följande exempel läggs en ny definition av anpassade säkerhetsattribut som stöder flera fördefinierade värden.

• Attributuppsättning: Engineering
• Attributet: Project
• Attributdatatyp: Samling strängar

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

Skapa 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

Ingen

Lägga till en definition av anpassade säkerhetsattribut med en lista över fördefinierade värden

I följande exempel läggs en ny definition av anpassade säkerhetsattribut till med en lista över fördefinierade värden.

• Attributuppsättning: Engineering
• Attributet: Project
• Attributdatatyp: Samling strängar
• Fördefinierade värden: 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

Skapa 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

Ingen

Uppdatera en definition för anpassade säkerhetsattribut

I följande exempel uppdateras en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: ProjectDate

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

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

Uppdatera de fördefinierade värdena för en definition av anpassade säkerhetsattribut

I följande exempel uppdateras de fördefinierade värdena för en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: Project
• Attributdatatyp: Samling strängar
• Uppdatera fördefinierat värde: Baker
• Nytt fördefinierat värde: Skagit

PowerShell

Invoke-MgGraphRequest

Kommentar

För den här begäran måste du lägga till huvudet OData-Version och tilldela det värdet 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

Uppdatera customSecurityAttributeDefinition

Kommentar

För den här begäran måste du lägga till huvudet OData-Version och tilldela det värdet 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

Ingen

Inaktivera en definition för anpassade säkerhetsattribut

I följande exempel inaktiveras en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: Project

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Microsoft Graph

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

Hämta alla fördefinierade värden

I följande exempel hämtas alla fördefinierade värden för en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: 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 allowedValues

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

Azure AD PowerShell

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

Hämta ett fördefinierat värde

I följande exempel hämtas ett fördefinierat värde för en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: Project
• Fördefinierat värde: 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

Hämta 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" 

Lägga till ett fördefinierat värde

I följande exempel läggs ett fördefinierat värde till för en definition av anpassade säkerhetsattribut.

Du kan lägga till fördefinierade värden för anpassade säkerhetsattribut som har usePreDefinedValuesOnly angetts till true.

• Attributuppsättning: Engineering
• Attributet: Project
• Fördefinierat värde: 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

Skapa 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

Inaktivera ett fördefinierat värde

I följande exempel inaktiveras ett fördefinierat värde för en definition av anpassade säkerhetsattribut.

• Attributuppsättning: Engineering
• Attributet: Project
• Fördefinierat värde: Alpine

PowerShell

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

Microsoft Graph

Uppdatera 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

Vanliga frågor och svar

Kan du ta bort definitioner för anpassade säkerhetsattribut?

Nej, du kan inte ta bort definitioner för anpassade säkerhetsattribut. Du kan bara inaktivera definitioner för anpassade säkerhetsattribut. När du inaktiverar ett anpassat säkerhetsattribut kan det inte längre tillämpas på Microsoft Entra-objekten. Anpassade tilldelningar av säkerhetsattribut för den inaktiverade definitionen av anpassade säkerhetsattribut tas inte bort automatiskt. Det finns ingen gräns för antalet inaktiverade anpassade säkerhetsattribut. Du kan ha 500 aktiva definitioner för anpassade säkerhetsattribut per klientorganisation med 100 tillåtna fördefinierade värden per definition av anpassade säkerhetsattribut.

Nästa steg

• Hantera åtkomst till anpassade säkerhetsattribut i Microsoft Entra-ID
• Tilldela, uppdatera, lista eller ta bort anpassade säkerhetsattribut för en användare
• Tilldela, uppdatera, lista eller ta bort anpassade säkerhetsattribut för ett program