Aangepaste beveiligingskenmerken voor een gebruiker toewijzen, bijwerken, weergeven of verwijderen

Aangepaste beveiligingskenmerken in Microsoft Entra-id, onderdeel van Microsoft Entra, zijn bedrijfsspecifieke kenmerken (sleutel-waardeparen) die u kunt definiëren en toewijzen aan Microsoft Entra-objecten. U kunt bijvoorbeeld een aangepast beveiligingskenmerk toewijzen om uw werknemers te filteren of om te bepalen wie toegang krijgt tot resources. In dit artikel wordt beschreven hoe u aangepaste beveiligingskenmerken voor Microsoft Entra-id toewijst, bijwerkt, vermeldt of verwijdert.

Vereisten

Als u aangepaste beveiligingskenmerken voor een gebruiker in uw Microsoft Entra-tenant wilt toewijzen of verwijderen, hebt u het volgende nodig:

• Kenmerktoewijzingsbeheerder
• Microsoft.Graph-module bij gebruik van Microsoft Graph PowerShell
• AzureADPreview versie 2.0.2.138 of hoger bij gebruik van Azure AD PowerShell

Belangrijk

Globale beheerder en andere beheerdersrollen hebben standaard geen machtigingen voor het lezen, definiëren en toewijzen van aangepaste beveiligingskenmerken.

Aangepaste beveiligingskenmerken toewijzen aan een gebruiker

Tip

Stappen in dit artikel kunnen enigszins variëren op basis van de portal waaruit u begint.

1. Meld u aan bij het Microsoft Entra-beheercentrum als kenmerktoewijzing Beheer istrator.

2. Zorg ervoor dat u aangepaste beveiligingskenmerken hebt gedefinieerd. Zie Aangepaste beveiligingskenmerkdefinities toevoegen of deactiveren in Microsoft Entra-id voor meer informatie.

3. Blader naar Identiteitsgebruikers>>Alle gebruikers.

4. Zoek en selecteer de gebruiker waaraan u aangepaste beveiligingskenmerken wilt toewijzen.

5. Selecteer aangepaste beveiligingskenmerken in de sectie Beheren.

6. Selecteer Toewijzing toevoegen.

7. Selecteer in Kenmerkset een kenmerkset in de lijst.

8. Selecteer in Kenmerknaam een aangepast beveiligingskenmerk in de lijst.

9. Afhankelijk van de eigenschappen van het geselecteerde aangepaste beveiligingskenmerk kunt u één waarde invoeren, een waarde selecteren in een vooraf gedefinieerde lijst of meerdere waarden toevoegen.

   • Voor aangepaste vrijevormbeveiligingskenmerken met één waarde voert u een waarde in het vak Toegewezen waarden in.
   • Voor vooraf gedefinieerde waarden voor aangepaste beveiligingskenmerken selecteert u een waarde in de lijst Toegewezen waarden.
   • Voor aangepaste beveiligingskenmerken met meerdere waarden selecteert u Waarden toevoegen om het deelvenster Kenmerkwaarden te openen en uw waarden toe te voegen. Wanneer u klaar bent met het toevoegen van waarden, selecteert u Gereed.

   

10. Wanneer u klaar bent, selecteert u Opslaan om de aangepaste beveiligingskenmerken toe te wijzen aan de gebruiker.

Toewijzingswaarden van aangepaste beveiligingskenmerken voor een gebruiker bijwerken

1. Meld u aan bij het Microsoft Entra-beheercentrum als kenmerktoewijzing Beheer istrator.

2. Blader naar Identiteitsgebruikers>>Alle gebruikers.

3. Zoek en selecteer de gebruiker die een aangepast beveiligingskenmerk bevat met de toewijzingswaarde die u wilt bijwerken.

4. Selecteer aangepaste beveiligingskenmerken in de sectie Beheren.

5. Zoek het aangepaste beveiligingskenmerk waarvan u de toewijzingswaarde wilt bijwerken.

   Zodra u een aangepast beveiligingskenmerk aan een gebruiker hebt toegewezen, kunt u alleen de waarde van het aangepaste beveiligingskenmerk wijzigen. U kunt geen andere eigenschappen van het aangepaste beveiligingskenmerk wijzigen, zoals de kenmerkset of de kenmerknaam.

6. Afhankelijk van de eigenschappen van het geselecteerde aangepaste beveiligingskenmerk kunt u één waarde bijwerken, een waarde selecteren in een vooraf gedefinieerde lijst of meerdere waarden bijwerken.

7. Selecteer Opslaan wanneer u klaar bent.

Gebruikers filteren op basis van aangepaste toewijzingen van beveiligingskenmerken

U kunt de lijst met aangepaste beveiligingskenmerken die zijn toegewezen aan gebruikers filteren op de pagina Alle gebruikers.

1. Meld u als een kenmerktoewijzingslezer aan bij het Microsoft Entra-beheercentrum.

2. Blader naar Identiteitsgebruikers>>Alle gebruikers.

3. Selecteer Filter toevoegen om het deelvenster Filter toevoegen te openen.

4. Selecteer Aangepaste beveiligingskenmerken.

5. Selecteer uw kenmerkset en kenmerknaam.

6. Voor Operator kunt u gelijk aan (==), niet gelijk aan (!=) of beginnen met selecteren.

7. Voor Waarde voert u een waarde in of selecteert u deze.

   

8. Als u het filter wilt toepassen, selecteert u Toepassen.

Toewijzingen van aangepaste beveiligingskenmerken verwijderen van een gebruiker

1. Meld u aan bij het Microsoft Entra-beheercentrum als kenmerktoewijzing Beheer istrator.

2. Blader naar Identiteitsgebruikers>>Alle gebruikers.

3. Zoek en selecteer de gebruiker die de toewijzingen van aangepaste beveiligingskenmerken bevat die u wilt verwijderen.

4. Selecteer aangepaste beveiligingskenmerken in de sectie Beheren.

5. Voeg vinkjes toe naast alle toewijzingen van aangepaste beveiligingskenmerken die u wilt verwijderen.

6. Selecteer Toewijzing verwijderen.

PowerShell of Microsoft Graph API

Als u aangepaste toewijzingen van beveiligingskenmerken voor gebruikers in uw Microsoft Entra-organisatie wilt beheren, kunt u PowerShell of Microsoft Graph API gebruiken. De volgende voorbeelden kunnen worden gebruikt voor het beheren van opdrachten.

Een aangepast beveiligingskenmerk met een tekenreekswaarde toewijzen aan een gebruiker

In het volgende voorbeeld wordt een aangepast beveiligingskenmerk met een tekenreekswaarde aan een gebruiker toegewezen.

• Kenmerkset: Engineering
• Kenmerk: ProjectDate
• Kenmerkgegevenstype: Tekenreeks
• Kenmerkwaarde: "2024-11-15"

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "ProjectDate" = "2024-11-15"
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "ProjectDate":"2024-11-15"
        }
    }
}

PowerShell voor Azure AD

Geen

Een aangepast beveiligingskenmerk met een waarde voor meerdere tekenreeksen toewijzen aan een gebruiker

In het volgende voorbeeld wordt een aangepast beveiligingskenmerk met een waarde voor meerdere tekenreeksen aan een gebruiker toegewezen.

• Kenmerkset: Engineering
• Kenmerk: Project
• Gegevenstype van kenmerk: verzameling tekenreeksen
• Kenmerkwaarde: ["Baker","Cascade"]

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        "Project" = @("Baker","Cascade")
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project@odata.type":"#Collection(String)",
            "Project":["Baker","Cascade"]
        }
    }
}

PowerShell voor Azure AD

Set-AzureADMSUser

$attributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Baker","Cascade")
    }
}
Set-AzureADMSUser -Id dbb22700-a7de-4372-ae78-0098ee60e55e -CustomSecurityAttributes $attributes

Een aangepast beveiligingskenmerk met een waarde voor geheel getal toewijzen aan een gebruiker

In het volgende voorbeeld wordt een aangepast beveiligingskenmerk met een geheel getal aan een gebruiker toegewezen.

• Kenmerkset: Engineering
• Kenmerk: NumVendors
• Kenmerkgegevenstype: Geheel getal
• Kenmerkwaarde: 4

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "NumVendors@odata.type" = "#Int32"
        "NumVendors" = 4
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "NumVendors@odata.type":"#Int32",
            "NumVendors":4
        }
    }
}

PowerShell voor Azure AD

Geen

Een aangepast beveiligingskenmerk met een waarde voor meerdere gehele getallen toewijzen aan een gebruiker

In het volgende voorbeeld wordt een aangepast beveiligingskenmerk met een waarde met meerdere gehele getallen aan een gebruiker toegewezen.

• Kenmerkset: Engineering
• Kenmerk: CostCenter
• Kenmerkgegevenstype: Verzameling gehele getallen
• Kenmerkwaarde: [1001,1003]

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "CostCenter@odata.type" = "#Collection(Int32)"
        "CostCenter" = @(1001,1003)
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "CostCenter@odata.type":"#Collection(Int32)",
            "CostCenter":[1001,1003]
        }
    }
}

PowerShell voor Azure AD

Geen

Een aangepast beveiligingskenmerk met een booleaanse waarde toewijzen aan een gebruiker

In het volgende voorbeeld wordt een aangepast beveiligingskenmerk met een Booleaanse waarde aan een gebruiker toegewezen.

• Kenmerkset: Engineering
• Kenmerk: Certification
• Kenmerkgegevenstype: Booleaans
• Kenmerkwaarde: true

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Certification" = $true
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Certification":true
        }
    }
}

PowerShell voor Azure AD

Geen

Een aangepaste toewijzing van beveiligingskenmerken bijwerken met een geheel getal voor een gebruiker

In het volgende voorbeeld wordt een aangepaste toewijzing van beveiligingskenmerken bijgewerkt met een geheel getal voor een gebruiker.

• Kenmerkset: Engineering
• Kenmerk: NumVendors
• Kenmerkgegevenstype: Geheel getal
• Kenmerkwaarde: 8

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "NumVendors@odata.type" = "#Int32"
        "NumVendors" = 8
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "NumVendors@odata.type":"#Int32",
            "NumVendors":8
        }
    }
}

PowerShell voor Azure AD

Geen

Een toewijzing van een aangepast beveiligingskenmerk bijwerken met een Booleaanse waarde voor een gebruiker

In het volgende voorbeeld wordt een aangepaste toewijzing van beveiligingskenmerken bijgewerkt met een Booleaanse waarde voor een gebruiker.

• Kenmerkset: Engineering
• Kenmerk: Certification
• Kenmerkgegevenstype: Booleaans
• Kenmerkwaarde: false

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Certification" = $false
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Certification":false
        }
    }
}

PowerShell voor Azure AD

Geen

Een aangepaste toewijzing van beveiligingskenmerken bijwerken met een waarde voor meerdere tekenreeksen voor een gebruiker

In het volgende voorbeeld wordt een aangepaste toewijzing van beveiligingskenmerken bijgewerkt met een waarde voor meerdere tekenreeksen voor een gebruiker.

• Kenmerkset: Engineering
• Kenmerk: Project
• Gegevenstype van kenmerk: verzameling tekenreeksen
• Kenmerkwaarde: ("Alpine","Baker")

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        "Project" = @("Alpine","Baker")
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project@odata.type":"#Collection(String)",
            "Project":["Alpine","Baker"]
        }
    }
}

PowerShell voor Azure AD

Set-AzureADMSUser

$attributesUpdate = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Alpine","Baker")
    }
}
Set-AzureADMSUser -Id dbb22700-a7de-4372-ae78-0098ee60e55e -CustomSecurityAttributes $attributesUpdate 

De aangepaste toewijzingen van beveiligingskenmerken ophalen voor een gebruiker

In het volgende voorbeeld worden de toewijzingen van aangepaste beveiligingskenmerken voor een gebruiker opgehaald.

PowerShell

Get-MgUser

$userAttributes = Get-MgUser -UserId $userId -Property "customSecurityAttributes"
$userAttributes.CustomSecurityAttributes.AdditionalProperties | Format-List
$userAttributes.CustomSecurityAttributes.AdditionalProperties.Engineering
$userAttributes.CustomSecurityAttributes.AdditionalProperties.Marketing

Key   : Engineering
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [Project@odata.type, #Collection(String)], [Project, System.Object[]],
        [ProjectDate, 2024-11-15]…}

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [EmployeeId, GS45897]}


Key                   Value
---                   -----
@odata.type           #microsoft.graph.customSecurityAttributeValue
Project@odata.type    #Collection(String)
Project               {Baker, Alpine}
ProjectDate           2024-11-15
NumVendors            8
CostCenter@odata.type #Collection(Int32)
CostCenter            {1001, 1003}
Certification         False


Key         Value
---         -----
@odata.type #microsoft.graph.customSecurityAttributeValue
EmployeeId  KX45897

Als er geen aangepaste beveiligingskenmerken zijn toegewezen aan de gebruiker of als de aanroepende principal geen toegang heeft, is het antwoord leeg.

Microsoft Graph

Gebruiker ophalen

GET https://graph.microsoft.com/v1.0/users/{id}?$select=customSecurityAttributes

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users(customSecurityAttributes)/$entity",
    "customSecurityAttributes": {
        "Engineering": {
            "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
            "Project@odata.type": "#Collection(String)",
            "Project": [
                "Baker",
                "Alpine"
            ],
            "ProjectDate": "2024-11-15",
            "NumVendors": 8,
            "CostCenter@odata.type": "#Collection(Int32)",
            "CostCenter": [
                1001,
                1003
            ],
            "Certification": false
        },
        "Marketing": {
            "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
            "EmployeeId": "GS45897"
        }
    }
}

Als er geen aangepaste beveiligingskenmerken zijn toegewezen aan de gebruiker of als de aanroepende principal geen toegang heeft, ziet het antwoord er als volgt uit:

{
    "customSecurityAttributes": null
}

PowerShell voor Azure AD

Get-AzureADMSUser

$user1 = Get-AzureADMSUser -Id dbb22700-a7de-4372-ae78-0098ee60e55e -Select CustomSecurityAttributes
$user1.CustomSecurityAttributes

Een lijst weergeven van alle gebruikers met een aangepaste toewijzing van beveiligingskenmerken die gelijk is aan een waarde

In het volgende voorbeeld worden alle gebruikers met een aangepaste toewijzing van beveiligingskenmerken weergegeven die gelijk is aan een waarde. Hiermee worden gebruikers opgehaald met een aangepast beveiligingskenmerk met de naam AppCountry een waarde die gelijk is Canadaaan. De filterwaarde is hoofdlettergevoelig. U moet de aanvraag of de header toevoegen ConsistencyLevel=eventual . U moet ook $count=true opnemen om ervoor te zorgen dat de aanvraag correct wordt gerouteerd.

• Kenmerkset: Marketing
• Kenmerk: AppCountry
• Filter: AppCountry eq 'Canada'

PowerShell

Get-MgUser

$userAttributes = Get-MgUser -CountVariable CountVar -Property "id,displayName,customSecurityAttributes" -Filter "customSecurityAttributes/Marketing/AppCountry eq 'Canada'" -ConsistencyLevel eventual
$userAttributes | select Id,DisplayName,CustomSecurityAttributes
$userAttributes.CustomSecurityAttributes.AdditionalProperties | Format-List

Id                                   DisplayName CustomSecurityAttributes
--                                   ----------- ------------------------
4b4e8090-e9ba-4bdc-b2f0-67c3c7c59489 Jiya        Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
efdf3082-64ae-495f-b051-855e2d8df969 Jana        Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue

Key   : Engineering
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [Datacenter@odata.type, #Collection(String)], [Datacenter, System.Object[]]}

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [AppCountry@odata.type, #Collection(String)], [AppCountry, System.Object[]],
        [EmployeeId, KX19476]}

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [AppCountry@odata.type, #Collection(String)], [AppCountry, System.Object[]],
        [EmployeeId, GS46982]}

Microsoft Graph

Gebruikers weergeven

GET https://graph.microsoft.com/v1.0/users?$count=true&$select=id,displayName,customSecurityAttributes&$filter=customSecurityAttributes/Marketing/AppCountry eq 'Canada'
ConsistencyLevel: eventual

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users(id,displayName,customSecurityAttributes)",
    "@odata.count": 2,
    "value": [
        {
            "id": "4b4e8090-e9ba-4bdc-b2f0-67c3c7c59489",
            "displayName": "Jiya",
            "customSecurityAttributes": {
                "Engineering": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "Datacenter@odata.type": "#Collection(String)",
                    "Datacenter": [
                        "India"
                    ]
                },
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "India",
                        "Canada"
                    ],
                    "EmployeeId": "KX19476"
                }
            }
        },
        {
            "id": "efdf3082-64ae-495f-b051-855e2d8df969",
            "displayName": "Jana",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Canada",
                        "Mexico"
                    ],
                    "EmployeeId": "GS46982"
                }
            }
        }
    ]
}

PowerShell voor Azure AD

Geen

Alle gebruikers weergeven met een aangepaste toewijzing van beveiligingskenmerken die beginnen met een waarde

In het volgende voorbeeld ziet u alle gebruikers met een aangepaste toewijzing van beveiligingskenmerken die beginnen met een waarde. Hiermee worden gebruikers opgehaald met een aangepast beveiligingskenmerk met de naam EmployeeId een waarde die begint met GS. De filterwaarde is hoofdlettergevoelig. U moet de aanvraag of de header toevoegen ConsistencyLevel=eventual . U moet ook $count=true opnemen om ervoor te zorgen dat de aanvraag correct wordt gerouteerd.

• Kenmerkset: Marketing
• Kenmerk: EmployeeId
• Filter: EmployeeId startsWith 'GS'

PowerShell

Get-MgUser

$userAttributes = Get-MgUser -CountVariable CountVar -Property "id,displayName,customSecurityAttributes" -Filter "startsWith(customSecurityAttributes/Marketing/EmployeeId,'GS')" -ConsistencyLevel eventual
$userAttributes | select Id,DisplayName,CustomSecurityAttributes
$userAttributes.CustomSecurityAttributes.AdditionalProperties | Format-List

Id                                   DisplayName CustomSecurityAttributes
--                                   ----------- ------------------------
02d52406-be75-411b-b02f-29d7f38dcf62 Chandra     Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
efdf3082-64ae-495f-b051-855e2d8df969 Jana        Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
d5a1c025-2d79-4ad3-9217-91ac3a4ed8b8 Joe         Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [EmployeeId, GS36348]}

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [AppCountry@odata.type, #Collection(String)], [AppCountry, System.Object[]],
        [EmployeeId, GS46982]}

Key   : Engineering
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [Project@odata.type, #Collection(String)], [Project, System.Object[]],
        [ProjectDate, 2024-11-15]…}

Key   : Marketing
Value : {[@odata.type, #microsoft.graph.customSecurityAttributeValue], [EmployeeId, GS45897]}

Microsoft Graph

Gebruikers weergeven

GET https://graph.microsoft.com/v1.0/users?$count=true&$select=id,displayName,customSecurityAttributes&$filter=startsWith(customSecurityAttributes/Marketing/EmployeeId,'GS')
ConsistencyLevel: eventual

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users(id,displayName,customSecurityAttributes)",
    "@odata.count": 3,
    "value": [
        {
            "id": "02d52406-be75-411b-b02f-29d7f38dcf62",
            "displayName": "Chandra",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS36348"
                }
            }
        },
        {
            "id": "efdf3082-64ae-495f-b051-855e2d8df969",
            "displayName": "Jana",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Canada",
                        "Mexico"
                    ],
                    "EmployeeId": "GS46982"
                }
            }
        },
        {
            "id": "d5a1c025-2d79-4ad3-9217-91ac3a4ed8b8",
            "displayName": "Joe",
            "customSecurityAttributes": {
                "Engineering": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "Project@odata.type": "#Collection(String)",
                    "Project": [
                        "Baker",
                        "Alpine"
                    ],
                    "ProjectDate": "2024-11-15",
                    "NumVendors": 8,
                    "CostCenter@odata.type": "#Collection(Int32)",
                    "CostCenter": [
                        1001,
                        1003
                    ],
                    "Certification": false
                },
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS45897"
                }
            }
        }
    ]
}

PowerShell voor Azure AD

Geen

Alle gebruikers weergeven met een aangepaste toewijzing van beveiligingskenmerken die niet gelijk zijn aan een waarde

In het volgende voorbeeld worden alle gebruikers met een aangepaste toewijzing van beveiligingskenmerken weergegeven die niet gelijk is aan een waarde. Hiermee worden gebruikers opgehaald met een aangepast beveiligingskenmerk met de naam AppCountry een waarde die niet gelijk is Canadaaan. De filterwaarde is hoofdlettergevoelig. U moet de aanvraag of de header toevoegen ConsistencyLevel=eventual . U moet ook $count=true opnemen om ervoor te zorgen dat de aanvraag correct wordt gerouteerd.

• Kenmerkset: Marketing
• Kenmerk: AppCountry
• Filter: AppCountry ne 'Canada'

PowerShell

Get-MgUser

$userAttributes = Get-MgUser -CountVariable CountVar -Property "id,displayName,customSecurityAttributes" -Filter "customSecurityAttributes/Marketing/AppCountry ne 'Canada'" -ConsistencyLevel eventual
$userAttributes | select Id,DisplayName,CustomSecurityAttributes

Id                                   DisplayName              CustomSecurityAttributes
--                                   -----------              ------------------------
02d52406-be75-411b-b02f-29d7f38dcf62 Chandra                  Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
eaea4971-7764-4498-9aeb-776496812e75 Isabella                 Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
d937580c-692c-451f-a507-6758d3bdf353 Alain                    Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
d5a1c025-2d79-4ad3-9217-91ac3a4ed8b8 Joe                      Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
23ad8721-f46c-421a-9785-33b0ef474198 Dara                     Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue

Microsoft Graph

Gebruikers weergeven

GET https://graph.microsoft.com/v1.0/users?$count=true&$select=id,displayName,customSecurityAttributes&$filter=customSecurityAttributes/Marketing/AppCountry ne 'Canada'
ConsistencyLevel: eventual

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users(id,displayName,customSecurityAttributes)",
    "@odata.count": 47,
    "value": [
        {
            "id": "02d52406-be75-411b-b02f-29d7f38dcf62",
            "displayName": "Chandra",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS36348"
                }
            }
        },
        {
            "id": "eaea4971-7764-4498-9aeb-776496812e75",
            "displayName": "Isabella",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "France"
                    ]
                }
            }
        },
        {
            "id": "d937580c-692c-451f-a507-6758d3bdf353",
            "displayName": "Alain",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Germany",
                        "Japan"
                    ]
                }
            }
        },
        {
            "id": "d5a1c025-2d79-4ad3-9217-91ac3a4ed8b8",
            "displayName": "Joe",
            "customSecurityAttributes": {
                "Engineering": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "Project@odata.type": "#Collection(String)",
                    "Project": [
                        "Baker",
                        "Alpine"
                    ],
                    "ProjectDate": "2024-11-15",
                    "NumVendors": 8,
                    "CostCenter@odata.type": "#Collection(Int32)",
                    "CostCenter": [
                        1001,
                        1003
                    ],
                    "Certification": false
                },
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS45897"
                }
            }
        },
        {
            "id": "23ad8721-f46c-421a-9785-33b0ef474198",
            "displayName": "Dara",
            "customSecurityAttributes": null
        }
    ]
}

PowerShell voor Azure AD

Geen

Een toewijzing van een aangepast beveiligingskenmerk met één waarde verwijderen van een gebruiker

In het volgende voorbeeld wordt een toewijzing van een aangepast beveiligingskenmerk met één waarde van een gebruiker verwijderd door de waarde in te stellen op null.

• Kenmerkset: Engineering
• Kenmerk: ProjectDate
• Kenmerkwaarde: null

PowerShell

Invoke-MgGraphRequest

$params = @{
    "customSecurityAttributes" = @{
        "Engineering" = @{
            "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
            "ProjectDate" = $null
        }
    }
}
Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/users/$userId" -Body $params

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "ProjectDate":null
        }
    }
}

PowerShell voor Azure AD

Geen

Een toewijzing van een aangepaste beveiligingskenmerk met meerdere waarden verwijderen van een gebruiker

In het volgende voorbeeld wordt een aangepaste toewijzing van beveiligingskenmerken met meerdere waarden van een gebruiker verwijderd door de waarde in te stellen op een lege verzameling.

• Kenmerkset: Engineering
• Kenmerk: Project
• Kenmerkwaarde: []

PowerShell

Update-MgUser

$customSecurityAttributes = @{
    "Engineering" = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project" = @()
    }
}
Update-MgUser -UserId $userId -CustomSecurityAttributes $customSecurityAttributes

Microsoft Graph

Gebruiker bijwerken

PATCH https://graph.microsoft.com/v1.0/users/{id}
{
    "customSecurityAttributes":
    {
        "Engineering":
        {
            "@odata.type":"#Microsoft.DirectoryServices.CustomSecurityAttributeValue",
            "Project":[]
        }
    }
}

PowerShell voor Azure AD

Geen

Veelgestelde vragen

Waar worden aangepaste toewijzingen van beveiligingskenmerken voor gebruikers ondersteund?

Aangepaste toewijzingen van beveiligingskenmerken voor gebruikers worden ondersteund in het Microsoft Entra-beheercentrum, PowerShell en Microsoft Graph-API's. Aangepaste toewijzingen van beveiligingskenmerken worden niet ondersteund in Mijn apps of Microsoft 365-beheercentrum.

Wie kan de aangepaste beveiligingskenmerken weergeven die zijn toegewezen aan een gebruiker?

Alleen gebruikers aan wie de rollen Kenmerktoewijzingsbeheerder of Kenmerktoewijzingslezer op tenantbereik zijn toegewezen, kunnen aangepaste beveiligingskenmerken weergeven die zijn toegewezen aan gebruikers in de tenant. Gebruikers kunnen de aangepaste beveiligingskenmerken die zijn toegewezen aan hun eigen profiel of andere gebruikers niet weergeven. Gasten kunnen de aangepaste beveiligingskenmerken niet weergeven, ongeacht de gastmachtigingen die zijn ingesteld voor de tenant.

Moet ik een app maken om aangepaste toewijzingen van beveiligingskenmerken toe te voegen?

Nee, aangepaste beveiligingskenmerken kunnen worden toegewezen aan gebruikersobjecten zonder dat hiervoor een toepassing nodig is.

Waarom krijg ik een foutmelding bij het opslaan van aangepaste beveiligingskenmerktoewijzingen?

U bent niet gemachtigd om aangepaste beveiligingskenmerken toe te wijzen aan gebruikers. Zorg ervoor de rol Kenmerktoewijzingsbeheerder aan u is toegewezen.

Kan ik aangepaste beveiligingskenmerken toewijzen aan gasten?

Ja, aangepaste beveiligingskenmerken kunnen worden toegewezen aan leden of gasten in uw tenant.

Kan ik aangepaste beveiligingskenmerken toewijzen aan met directory gesynchroniseerde gebruikers?

Ja, aan via directory gesynchroniseerde gebruikers vanuit een on-premises Active Directory kunnen aangepaste beveiligingskenmerken worden toegewezen.

Zijn aangepaste toewijzingen van beveiligingskenmerken beschikbaar voor dynamische lidmaatschapsregels?

Nee, aangepaste beveiligingskenmerken die aan gebruikers zijn toegewezen, worden niet ondersteund voor het configureren van dynamische lidmaatschapsregels.

Zijn aangepaste beveiligingskenmerken hetzelfde als de aangepaste kenmerken in B2C-tenants?

Nee, aangepaste beveiligingskenmerken worden niet ondersteund in B2C-tenants en zijn niet gerelateerd aan B2C-functies.

Volgende stappen

• Aangepaste beveiligingskenmerkdefinities toevoegen of deactiveren in Microsoft Entra-id
• Aangepaste beveiligingskenmerken voor een toepassing toewijzen, bijwerken, weergeven of verwijderen
• Voorbeelden: Aangepaste toewijzingen van beveiligingskenmerken toewijzen, bijwerken, weergeven of verwijderen met behulp van de Microsoft Graph API
• Problemen met aangepaste beveiligingskenmerken in Microsoft Entra-id oplossen