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

Artikel
11/15/2023

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.

Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.
Bläddra till Anpassade säkerhetsattribut för skydd>.
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.
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.
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

Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.
Bläddra till Anpassade säkerhetsattribut för skydd>.
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.
Klicka för att öppna den valda attributuppsättningen.
Klicka på Lägg till attribut för att lägga till ett nytt anpassat säkerhetsattribut i attributuppsättningen.
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.
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.
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.
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.
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.
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.
När det är klart klickar du på Spara.

Det nya anpassade säkerhetsattributet visas i listan över anpassade säkerhetsattribut.
Om du vill inkludera fördefinierade värden följer du stegen i nästa avsnitt.

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.

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.

Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.
Bläddra till Anpassade säkerhetsattribut för skydd>.
Klicka på den attributuppsättning som innehåller det anpassade säkerhetsattribut som du vill redigera.
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.
Redigera de egenskaper som är aktiverade.
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.

Logga in på administrationscentret för Microsoft Entra som attributdefinitionsadministratör.
Bläddra till Anpassade säkerhetsattribut för skydd>.
Klicka på den attributuppsättning som innehåller det anpassade säkerhetsattributet som du vill inaktivera.
I listan över anpassade säkerhetsattribut lägger du till en bockmarkering bredvid det anpassade säkerhetsattribut som du vill inaktivera.
Klicka på Inaktivera attribut.
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.

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 : {}

Lista attributUppsättningar

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

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

Hämta de främsta attributuppsättningarna

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

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

Lista attributUppsättningar

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

Hämta attributuppsättningar i ordning

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

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

Lista attributUppsättningar

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

Hämta en attributuppsättning

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

Attributuppsättning: Engineering

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

Hämta attributeSet

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

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

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

Skapa attributeSet

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

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

Update-MgDirectoryAttributeSet

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

Uppdatera attributUppsättning

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

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.

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    : {}

Lista customSecurityAttributeDefinitions

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

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'

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    : {}

Lista customSecurityAttributeDefinitions

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

Filter: Attributuppsättningen eq 'Engineering' och status eq 'Available' och datatypen eq 'String'

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    : {}

Lista customSecurityAttributeDefinitions

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

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

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

Hämta customSecurityAttributeDefinition

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

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

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

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
}

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

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

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
}

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

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

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

Uppdatera en definition för anpassade säkerhetsattribut

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

Attributuppsättning: Engineering
Attributet: ProjectDate

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Uppdatera customSecurityAttributeDefinition

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

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

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

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

Inaktivera en definition för anpassade säkerhetsattribut

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

Attributuppsättning: Engineering
Attributet: Project

Update-MgDirectoryCustomSecurityAttributeDefinition

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

Uppdatera customSecurityAttributeDefinition

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

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

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 : {}

Lista allowedValues

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

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

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

Hämta allowedValue

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

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

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

Skapa allowedValue

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

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

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

Uppdatera allowedValue

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

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.

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

Förutsättningar

Lägga till en attributuppsättning

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

Redigera en definition för anpassade säkerhetsattribut

Inaktivera en definition för anpassade säkerhetsattribut

PowerShell eller Microsoft Graph API

Hämta alla attributuppsättningar

Hämta de främsta attributuppsättningarna

Hämta attributuppsättningar i ordning

Hämta en attributuppsättning

Lägga till en attributuppsättning

Uppdatera en attributuppsättning

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

Filtrera definitioner för anpassade säkerhetsattribut

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

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

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

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

Uppdatera en definition för anpassade säkerhetsattribut

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

Inaktivera en definition för anpassade säkerhetsattribut

Hämta alla fördefinierade värden

Hämta ett fördefinierat värde

Lägga till ett fördefinierat värde

Inaktivera ett fördefinierat värde

Vanliga frågor och svar

Nästa steg

Ytterligare resurser