Felhasználó egyéni biztonsági attribútumainak hozzárendelése, frissítése, listázása vagy eltávolítása

A Microsoft Entra ID-ban, a Microsoft Entra részeként található egyéni biztonsági attribútumok olyan üzletspecifikus attribútumok (kulcs-érték párok), amelyeket definiálhat és hozzárendelhet a Microsoft Entra-objektumokhoz. Hozzárendelhet például egyéni biztonsági attribútumot az alkalmazottak szűréséhez, vagy annak meghatározásához, hogy ki fér hozzá az erőforrásokhoz. Ez a cikk bemutatja, hogyan rendelhet hozzá, frissíthet, listázhat vagy távolíthat el egyéni biztonsági attribútumokat a Microsoft Entra ID-hoz.

Előfeltételek

A Microsoft Entra-bérlőben lévő felhasználók egyéni biztonsági attribútumainak hozzárendeléséhez vagy eltávolításához a következőkre van szükség:

• Attribútum-hozzárendelési Rendszergazda istrator
• Microsoft.Graph modul a Microsoft Graph PowerShell használatakor
• AzureADPreview 2.0.2.138-as vagy újabb verzió az Azure AD PowerShell használatakor

Fontos

Alapértelmezés szerint a globális Rendszergazda istrator és más rendszergazdai szerepkörök nem rendelkeznek egyéni biztonsági attribútumok olvasására, definiálására vagy hozzárendelésére vonatkozó engedélyekkel.

Egyéni biztonsági attribútumok hozzárendelése felhasználóhoz

Tipp.

A cikkben szereplő lépések a portáltól függően kissé eltérhetnek.

1. Jelentkezzen be a Microsoft Entra felügyeleti központba attribútum-hozzárendelési Rendszergazda istratorként.

2. Győződjön meg arról, hogy egyéni biztonsági attribútumokat definiált. További információ: Egyéni biztonsági attribútumdefiníciók hozzáadása vagy inaktiválása a Microsoft Entra-azonosítóban.

3. Tallózással keresse meg az Identitásfelhasználók>>minden felhasználót.

4. Keresse meg és jelölje ki azt a felhasználót, akihez egyéni biztonsági attribútumokat szeretne hozzárendelni.

5. A Kezelés szakaszban válassza az Egyéni biztonsági attribútumok lehetőséget.

6. Válassza a Hozzárendelés hozzáadása lehetőséget.

7. Az Attribútumkészletben válasszon ki egy attribútumkészletet a listából.

8. Az Attribútum nevében válasszon ki egy egyéni biztonsági attribútumot a listából.

9. A kiválasztott egyéni biztonsági attribútum tulajdonságaitól függően megadhat egyetlen értéket, kiválaszthat egy értéket egy előre definiált listából, vagy hozzáadhat több értéket.

   • Szabadkérelmű, egyértékű egyéni biztonsági attribútumok esetén adjon meg egy értéket a Hozzárendelt értékek mezőbe.
   • Előre definiált egyéni biztonsági attribútumértékek esetén válasszon ki egy értéket a Hozzárendelt értékek listából.
   • Többértékű egyéni biztonsági attribútumok esetén válassza az Értékek hozzáadása lehetőséget az Attribútumértékek panel megnyitásához és az értékek hozzáadásához. Ha befejezte az értékek hozzáadását, válassza a Kész elemet.

   

10. Ha végzett, a Mentés gombra kattintva rendelje hozzá az egyéni biztonsági attribútumokat a felhasználóhoz.

Felhasználó egyéni biztonsági attribútum-hozzárendelési értékeinek frissítése

1. Jelentkezzen be a Microsoft Entra felügyeleti központba attribútum-hozzárendelési Rendszergazda istratorként.

2. Tallózással keresse meg az Identitásfelhasználók>>minden felhasználót.

3. Keresse meg és jelölje ki azt a felhasználót, akinek egyéni biztonsági attribútum-hozzárendelési értékét frissíteni szeretné.

4. A Kezelés szakaszban válassza az Egyéni biztonsági attribútumok lehetőséget.

5. Keresse meg a frissíteni kívánt egyéni biztonsági attribútum hozzárendelési értékét.

   Miután hozzárendelt egy egyéni biztonsági attribútumot egy felhasználóhoz, csak az egyéni biztonsági attribútum értékét módosíthatja. Az egyéni biztonsági attribútum egyéb tulajdonságai, például az attribútumkészlet vagy az attribútum neve nem módosíthatók.

6. A kiválasztott egyéni biztonsági attribútum tulajdonságaitól függően frissíthet egyetlen értéket, kiválaszthat egy értéket egy előre definiált listából, vagy frissíthet több értéket.

7. Ha végzett, válassza a Mentés lehetőséget.

Felhasználók szűrése egyéni biztonsági attribútum-hozzárendelések alapján

A Felhasználókhoz rendelt egyéni biztonsági attribútumok listáját a Minden felhasználó lapon szűrheti.

1. Jelentkezzen be a Microsoft Entra Felügyeleti központba attribútum-hozzárendelés-olvasóként.

2. Tallózással keresse meg az Identitásfelhasználók>>minden felhasználót.

3. A Szűrő hozzáadása panel megnyitásához válassza a Szűrő hozzáadása lehetőséget.

4. Válassza ki az egyéni biztonsági attribútumokat.

5. Válassza ki az attribútumkészletet és az attribútum nevét.

6. Operátor esetén választhat egyenlőséget (==), nem egyenlőt (!=), vagy kezdődhet.

7. Érték mezőben adjon meg vagy jelöljön ki egy értéket.

   

8. A szűrő alkalmazásához válassza az Alkalmaz lehetőséget.

Egyéni biztonsági attribútum-hozzárendelések eltávolítása egy felhasználótól

1. Jelentkezzen be a Microsoft Entra felügyeleti központba attribútum-hozzárendelési Rendszergazda istratorként.

2. Tallózással keresse meg az Identitásfelhasználók>>minden felhasználót.

3. Keresse meg és jelölje ki az eltávolítani kívánt egyéni biztonsági attribútum-hozzárendeléseket tartalmazó felhasználót.

4. A Kezelés szakaszban válassza az Egyéni biztonsági attribútumok lehetőséget.

5. Jelölje be az eltávolítani kívánt egyéni biztonsági attribútum-hozzárendelések melletti pipákat.

6. Válassza a Hozzárendelés eltávolítása lehetőséget.

PowerShell vagy Microsoft Graph API

A Microsoft Entra-szervezet felhasználói egyéni biztonsági attribútum-hozzárendeléseinek kezeléséhez használhatja a PowerShellt vagy a Microsoft Graph API-t. A hozzárendelések kezelésére az alábbi példák használhatók.

Egyéni biztonsági attribútum hozzárendelése sztringértékkel egy felhasználóhoz

Az alábbi példa egy egyéni biztonsági attribútumot rendel hozzá egy sztringértékkel egy felhasználóhoz.

• Attribútumkészlet: Engineering
• Attribútum: ProjectDate
• Attribútum adattípusa: Sztring
• Attribútum értéke: "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

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum hozzárendelése többsztringes értékkel egy felhasználóhoz

Az alábbi példa egy többsztringes értékkel rendelkező egyéni biztonsági attribútumot rendel egy felhasználóhoz.

• Attribútumkészlet: Engineering
• Attribútum: Project
• Attribútum adattípusa: Sztringek gyűjteménye
• Attribútum értéke: ["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

Felhasználó frissítése

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

Azure AD PowerShell

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

Egyéni biztonsági attribútum hozzárendelése egész számértékkel egy felhasználóhoz

Az alábbi példa egy egyéni biztonsági attribútumot rendel hozzá egy felhasználóhoz egész számmal.

• Attribútumkészlet: Engineering
• Attribútum: NumVendors
• Attribútum adattípusa: Egész szám
• Attribútum értéke: 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

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum hozzárendelése több egész számmal egy felhasználóhoz

Az alábbi példa egy több egész számot tartalmazó egyéni biztonsági attribútumot rendel egy felhasználóhoz.

• Attribútumkészlet: Engineering
• Attribútum: CostCenter
• Attribútum adattípusa: Egész számok gyűjteménye
• Attribútum értéke: [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

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum hozzárendelése logikai értékkel egy felhasználóhoz

Az alábbi példa egy logikai értékkel rendelkező egyéni biztonsági attribútumot rendel egy felhasználóhoz.

• Attribútumkészlet: Engineering
• Attribútum: Certification
• Attribútum adattípusa: logikai
• Attribútum értéke: true

PowerShell

Update-MgUser

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

Microsoft Graph

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum hozzárendelésének frissítése egy felhasználó egész számértékével

Az alábbi példa egy egyéni biztonsági attribútum hozzárendelését frissíti egy felhasználó egész számértékével.

• Attribútumkészlet: Engineering
• Attribútum: NumVendors
• Attribútum adattípusa: Egész szám
• Attribútum értéke: 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

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum-hozzárendelés frissítése egy felhasználó logikai értékével

Az alábbi példa egy egyéni biztonsági attribútum hozzárendelését frissíti egy felhasználó logikai értékével.

• Attribútumkészlet: Engineering
• Attribútum: Certification
• Attribútum adattípusa: logikai
• Attribútum értéke: false

PowerShell

Update-MgUser

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

Microsoft Graph

Felhasználó frissítése

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

Azure AD PowerShell

None

Egyéni biztonsági attribútum-hozzárendelés frissítése egy felhasználó többsztringes értékével

Az alábbi példa egy egyéni biztonsági attribútum hozzárendelését frissíti egy felhasználó többsztringes értékével.

• Attribútumkészlet: Engineering
• Attribútum: Project
• Attribútum adattípusa: Sztringek gyűjteménye
• Attribútum értéke: ("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

Felhasználó frissítése

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

Azure AD PowerShell

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 

Felhasználó egyéni biztonsági attribútum-hozzárendeléseinek lekérése

Az alábbi példa lekéri egy felhasználó egyéni biztonsági attribútum-hozzárendeléseit.

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

Ha nincs hozzárendelve egyéni biztonsági attribútum a felhasználóhoz, vagy ha a hívónév nem rendelkezik hozzáféréssel, a válasz üres lesz.

Microsoft Graph

Felhasználó lekérése

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

Ha nincs hozzárendelve egyéni biztonsági attribútum a felhasználóhoz, vagy ha a hívó tag nem rendelkezik hozzáféréssel, a válasz a következőképpen fog kinézni:

{
    "customSecurityAttributes": null
}

Azure AD PowerShell

Get-AzureADMSUser

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

Az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználó listázása, amely egy értékkel egyenlő

Az alábbi példa az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználót sorolja fel, amely egy értékkel egyenlő. Lekéri a felhasználókat egy egyéni biztonsági attribútummal, amelynek értéke AppCountry megegyezik Canada. A szűrő értéke megkülönbözteti a kis- és nagybetűk értékét. Hozzá kell adnia ConsistencyLevel=eventual a kéréshez vagy a fejléchez. Azt is meg kell adnia $count=true , hogy a kérés megfelelően legyen irányítva.

• Attribútumkészlet: Marketing
• Attribútum: AppCountry
• Szűrő: 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

Felhasználók listázása

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

Azure AD PowerShell

None

Az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználó listázása, amely egy értékkel kezdődik

Az alábbi példa az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználót sorolja fel, amely egy értékkel kezdődik. Beolvassa a felhasználókat egy egyéni biztonsági attribútummal, amelynek neve EmployeeId egy olyan érték, amely a következővel GSkezdődik: . A szűrő értéke megkülönbözteti a kis- és nagybetűk értékét. Hozzá kell adnia ConsistencyLevel=eventual a kéréshez vagy a fejléchez. Azt is meg kell adnia $count=true , hogy a kérés megfelelően legyen irányítva.

• Attribútumkészlet: Marketing
• Attribútum: EmployeeId
• Szűrő: 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

Felhasználók listázása

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

Azure AD PowerShell

None

Az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználó listázása, amely nem egyenlő egy értékkel

Az alábbi példa az összes olyan egyéni biztonsági attribútum-hozzárendeléssel rendelkező felhasználót felsorolja, amely nem egyenlő egy értékkel. Lekéri a nem egyenlő Canadaértékkel elnevezett AppCountry egyéni biztonsági attribútummal rendelkező felhasználókat. A szűrő értéke megkülönbözteti a kis- és nagybetűk értékét. Hozzá kell adnia ConsistencyLevel=eventual a kéréshez vagy a fejléchez. Azt is meg kell adnia $count=true , hogy a kérés megfelelően legyen irányítva.

• Attribútumkészlet: Marketing
• Attribútum: AppCountry
• Szűrő: 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

Felhasználók listázása

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

Azure AD PowerShell

None

Egyetlenértékű egyéni biztonsági attribútum hozzárendelésének eltávolítása egy felhasználótól

Az alábbi példa egy egyértékű egyéni biztonsági attribútum hozzárendelését távolítja el egy felhasználótól úgy, hogy az értéket null értékre állítja.

• Attribútumkészlet: Engineering
• Attribútum: ProjectDate
• Attribútum értéke: 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

Felhasználó frissítése

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

Azure AD PowerShell

None

Többértékű egyéni biztonsági attribútum hozzárendelésének eltávolítása egy felhasználótól

Az alábbi példa eltávolít egy többértékű egyéni biztonsági attribútum-hozzárendelést egy felhasználótól, ha az értéket üres gyűjteményre állítja.

• Attribútumkészlet: Engineering
• Attribútum: Project
• Attribútum értéke: []

PowerShell

Update-MgUser

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

Microsoft Graph

Felhasználó frissítése

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

Azure AD PowerShell

None

Gyakori kérdések

Hol támogatottak az egyéni biztonsági attribútum-hozzárendelések a felhasználók számára?

A felhasználók egyéni biztonsági attribútum-hozzárendelései támogatottak a Microsoft Entra felügyeleti központban, a PowerShellben és a Microsoft Graph API-kban. Az egyéni biztonsági attribútum-hozzárendelések nem támogatottak Saját alkalmazások vagy Microsoft 365 Felügyeleti központ.

Ki tekintheti meg a felhasználóhoz rendelt egyéni biztonsági attribútumokat?

Csak azok a felhasználók tekinthetik meg a bérlő hatókörében az attribútum-hozzárendelési Rendszergazda istrator vagy attribútum-hozzárendelés-olvasó szerepköröket, amelyek a bérlő bármely felhasználója számára hozzárendelt egyéni biztonsági attribútumokat tekinthetik meg. A felhasználók nem tekinthetik meg a saját profiljukhoz vagy más felhasználókhoz rendelt egyéni biztonsági attribútumokat. A vendégek a bérlőn beállított vendégengedélyektől függetlenül nem tekinthetik meg az egyéni biztonsági attribútumokat.

Létre kell hoznom egy alkalmazást egyéni biztonsági attribútum-hozzárendelések hozzáadásához?

Nem, az egyéni biztonsági attribútumok alkalmazás megkövetelése nélkül rendelhetők hozzá a felhasználói objektumokhoz.

Miért kapok továbbra is hibaüzenetet az egyéni biztonsági attribútum-hozzárendelések mentésére?

Nincs engedélye arra, hogy egyéni biztonsági attribútumokat rendeljen a felhasználókhoz. Győződjön meg arról, hogy hozzá van rendelve az attribútum-hozzárendelési Rendszergazda istrator szerepkörhöz.

Rendelhetek egyéni biztonsági attribútumokat a vendégekhez?

Igen, egyéni biztonsági attribútumok rendelhetők hozzá a bérlő tagjaihoz vagy vendégeihez.

Rendelhetek egyéni biztonsági attribútumokat a címtár szinkronizált felhasználóihoz?

Igen, a címtár által szinkronizált felhasználók egy helyi Active Directory egyéni biztonsági attribútumokhoz rendelhetők hozzá.

Elérhetők egyéni biztonsági attribútum-hozzárendelések a dinamikus tagsági szabályokhoz?

Nem, a felhasználókhoz rendelt egyéni biztonsági attribútumok nem támogatottak a dinamikus tagsági szabályok konfigurálásához.

Az egyéni biztonsági attribútumok megegyeznek a B2C-bérlők egyéni attribútumaival?

Nem, az egyéni biztonsági attribútumok nem támogatottak a B2C-bérlőkben, és nem kapcsolódnak a B2C-funkciókhoz.

További lépések

• Egyéni biztonsági attribútumdefiníciók hozzáadása vagy inaktiválása a Microsoft Entra-azonosítóban
• Egyéni biztonsági attribútumok hozzárendelése, frissítése, listázása vagy eltávolítása egy alkalmazáshoz
• Példák: Egyéni biztonsági attribútum-hozzárendelések hozzárendelése, frissítése, listázása vagy eltávolítása a Microsoft Graph API használatával
• Egyéni biztonsági attribútumok hibaelhárítása a Microsoft Entra-azonosítóban