ユーザーのカスタムセキュリティ属性の割り当て、更新、一覧表示、削除

[アーティクル]
11/15/2023

Microsoft Entra の一部である Microsoft Entra ID のカスタムセキュリティ属性は、ビジネス固有の属性 (キーと値のペア) であり、Microsoft Entra のオブジェクトに対して定義し割り当てることができます。たとえば、カスタムセキュリティ属性を割り当てて従業員をフィルター処理したり、リソースにアクセスできるユーザーを決定したりすることができます。この記事では、Microsoft Entra ID でのカスタムセキュリティ属性の割り当て、更新、一覧表示、削除の方法について説明します。

前提条件

Microsoft Entra テナント内のユーザーのカスタムセキュリティ属性の割り当てや削除には、次のものが必要です。

属性割り当て管理者
Microsoft Graph PowerShell を使用する場合、Microsoft.Graph モジュール
AzureADPreview バージョン 2.0.2.138 以降 (Azure AD PowerShell 使用時)

重要

既定では、グローバル管理者とその他の管理者ロールには、カスタムセキュリティ属性の読み取り、定義、割り当てを行う権限がありません。

カスタムセキュリティ属性のユーザーへの割り当て

ヒント

この記事の手順は、開始するポータルに応じて若干異なる場合があります。

Microsoft Entra 管理センターに属性割り当て管理者としてサインインしてください。
カスタムセキュリティ属性が定義されていることを確認します。詳細については、「Microsoft Entra ID でのカスタムセキュリティ属性定義の追加または非アクティブ化」を参照してください。
[ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
カスタムセキュリティ属性を割り当てるユーザーを検索して選択します。
[管理] セクションで、[カスタムセキュリティ属性] を選択してください。
[割り当ての追加] を選択します。
[Attribute set](属性セット) で、一覧から属性セットを選択します。
[属性名] で、一覧からカスタムセキュリティ属性を選択します。
選択したカスタムセキュリティ属性のプロパティに応じて、1 つの値を入力したり、定義済みの一覧から値を選択したり、複数の値を追加したりできます。
- 自由形式の単一値カスタムセキュリティ属性の場合は、[Assigned values](割り当てられた値) ボックスに値を入力します。
- 定義済みのカスタムセキュリティ属性値については、[Assigned values](割り当てられた値) リストから値を選択します。
- 複数値のカスタムセキュリティ属性の場合は、[Add values](値の追加) を選択して [Attribute values](属性値) ペインを開き、値を追加します。値の入力が完了したら、[OK] を選択します。
完了したら、[保存] を選択して、カスタムセキュリティ属性をユーザーに割り当てます。

ユーザーのカスタムセキュリティ属性の割り当て値を更新する

Microsoft Entra 管理センターに属性割り当て管理者としてサインインしてください。
[ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
更新するカスタムセキュリティ属性の割り当て値を持つユーザーを検索して選択します。
[管理] セクションで、[カスタムセキュリティ属性] を選択してください。
更新するカスタムセキュリティ属性の割り当て値を見つけます。

カスタムセキュリティ属性をユーザーに割り当てた後は、カスタムセキュリティ属性の値のみを変更できます。属性セットや属性名など、カスタムセキュリティ属性のその他のプロパティを変更することはできません。
選択したカスタムセキュリティ属性のプロパティに応じて、1つの値を更新したり、定義済みの一覧から値を選択したり、複数の値を更新したりできます。
終わったら、 [保存] を選択します。

カスタムセキュリティ属性割り当てに基づいてユーザーをフィルター処理する

[すべてのユーザー] ページで、ユーザーに割り当てられているカスタムセキュリティ属性のリストをフィルター処理できます。

Microsoft Entra 管理センターに属性割り当て閲覧者としてサインインしてください。
[ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
[フィルターを追加する] を選択して、[フィルターを追加する] ウィンドウを開きます。
[Custom security attributes](カスタムセキュリティ属性) を選択します。
属性セットと属性名を選択します。
[演算子]には、等号 (==)、不等号 (!=)、または [次の値で始まる] が選択できます。
[値] には、値を入力または選択します。
[適用] を選択して、フィルターを適用します。

ユーザーからカスタムセキュリティ属性の割り当てを削除する

Microsoft Entra 管理センターに属性割り当て管理者としてサインインしてください。
[ID]>[ユーザー]>[すべてのユーザー] の順に移動します。
削除するカスタムセキュリティ属性の割り当て値を持つユーザーを検索して選択します。
[管理] セクションで、[カスタムセキュリティ属性] を選択してください。
削除するすべてのカスタムセキュリティ属性の割り当ての横にチェックマークを追加します。
[割り当ての削除]を選択します。

PowerShell または Microsoft Graph API

Microsoft Entra 組織内のユーザーのカスタムセキュリティ属性の割り当てを管理するには、PowerShell または Microsoft Graph API を使用できます。割り当ての管理には、次の例を使用できます。

文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

次の例では、文字列値を持つカスタムセキュリティ属性をユーザーに割り当てます。

属性セット: Engineering
属性: ProjectDate
属性のデータ型: 文字列
属性値: "2024-11-15"

Update-MgUser

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

ユーザーの更新

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

複数の文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

次の例では、複数文字列値を持つカスタムセキュリティ属性をユーザーに割り当てます。

属性セット: Engineering
属性: Project
属性のデータ型: 文字列のコレクション
属性値: ["Baker","Cascade"]

Update-MgUser

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

ユーザーの更新

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

Set-AzureADMSUser

$attributes = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Baker","Cascade")
    }
}
Set-AzureADMSUser -Id 00aa00aa-bb11-cc22-dd33-44ee44ee44ee -CustomSecurityAttributes $attributes

整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

次の例では、整数値を持つカスタムセキュリティ属性をユーザーに割り当てます。

属性セット: Engineering
属性: NumVendors
属性のデータ型: 整数
属性値: 4

Update-MgUser

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

ユーザーの更新

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

複数の整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

次の例では、複数整数値を持つカスタムセキュリティ属性をユーザーに割り当てます。

属性セット: Engineering
属性: CostCenter
属性のデータ型: 整数のコレクション
属性値: [1001,1003]

Update-MgUser

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

ユーザーの更新

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

ブール値を持つカスタムセキュリティ属性をユーザーに割り当てる

次の例では、ブール値を持つカスタムセキュリティ属性をユーザーに割り当てます。

属性セット: Engineering
属性: Certification
属性のデータ型: ブール値
属性値: true

Update-MgUser

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

ユーザーの更新

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

ユーザーの整数値を持つカスタムセキュリティ属性割り当てを更新する

次の例では、ユーザーの整数値を持つカスタムセキュリティ属性割り当てを更新します。

属性セット: Engineering
属性: NumVendors
属性のデータ型: 整数
属性値: 8

Update-MgUser

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

ユーザーの更新

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

ユーザーのブール値を持つカスタムセキュリティ属性割り当てを更新する

次の例では、ユーザーのブール値を持つカスタムセキュリティ属性割り当てを更新します。

属性セット: Engineering
属性: Certification
属性のデータ型: ブール値
属性値: false

Update-MgUser

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

ユーザーの更新

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

ユーザーの複数文字列値を持つカスタムセキュリティ属性割り当てを更新する

次の例では、ユーザーの複数文字列値を持つカスタムセキュリティ属性割り当てを更新します。

属性セット: Engineering
属性: Project
属性のデータ型: 文字列のコレクション
属性値: ("Alpine","Baker")

Update-MgUser

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

ユーザーの更新

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

Set-AzureADMSUser

$attributesUpdate = @{
    Engineering = @{
        "@odata.type" = "#Microsoft.DirectoryServices.CustomSecurityAttributeValue"
        "Project@odata.type" = "#Collection(String)"
        Project = @("Alpine","Baker")
    }
}
Set-AzureADMSUser -Id 00aa00aa-bb11-cc22-dd33-44ee44ee44ee -CustomSecurityAttributes $attributesUpdate

ユーザーからカスタムセキュリティ属性の割り当てを取得する

次の例では、ユーザーのカスタムセキュリティ属性の割り当てを取得します。

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

ユーザーにカスタムセキュリティ属性が割り当てられていない場合、または呼び出し元のプリンシパルにアクセス権がない場合、応答は空になります。

ユーザーを取得する

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

ユーザーにカスタムセキュリティ属性が割り当てられていない場合、または呼び出し元のプリンシパルにアクセス権がない場合、応答は次のようになります。

{
    "customSecurityAttributes": null
}

Get-AzureADMSUser

$user1 = Get-AzureADMSUser -Id 00aa00aa-bb11-cc22-dd33-44ee44ee44ee -Select CustomSecurityAttributes
$user1.CustomSecurityAttributes

値と等しいカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

次の例では、値と等しいカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示します。値が Canada と等しい AppCountry という名前のカスタムセキュリティ属性を持つユーザーを取得します。フィルター値は大文字と小文字が区別されます。要求またはヘッダーに ConsistencyLevel=eventual を追加する必要があります。要求が正しくルーティングされるようにするには、 $count=true も含める必要があります。

属性セット: Marketing
属性: AppCountry
フィルター: AppCountry eq 'Canada'

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
--                                   ----------- ------------------------
00aa00aa-bb11-cc22-dd33-44ee44ee44ee Jiya        Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
11bb11bb-cc22-dd33-ee44-55ff55ff55ff 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]}

ユーザーの一覧表示

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": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
            "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": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
            "displayName": "Jana",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Canada",
                        "Mexico"
                    ],
                    "EmployeeId": "GS46982"
                }
            }
        }
    ]
}

値で始まるカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

次の例では、値で始まるカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示します。値が GS で始まる EmployeeId という名前のカスタムセキュリティ属性を持つユーザーを取得します。フィルター値は大文字と小文字が区別されます。要求またはヘッダーに ConsistencyLevel=eventual を追加する必要があります。要求が正しくルーティングされるようにするには、 $count=true も含める必要があります。

属性セット: Marketing
属性: EmployeeId
フィルター: EmployeeId startsWith 'GS'

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
--                                   ----------- ------------------------
22cc22cc-dd33-ee44-ff55-66aa66aa66aa Chandra     Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
11bb11bb-cc22-dd33-ee44-55ff55ff55ff Jana        Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
33dd33dd-ee44-ff55-aa66-77bb77bb77bb 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]}

ユーザーの一覧表示

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": "22cc22cc-dd33-ee44-ff55-66aa66aa66aa",
            "displayName": "Chandra",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS36348"
                }
            }
        },
        {
            "id": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
            "displayName": "Jana",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Canada",
                        "Mexico"
                    ],
                    "EmployeeId": "GS46982"
                }
            }
        },
        {
            "id": "33dd33dd-ee44-ff55-aa66-77bb77bb77bb",
            "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"
                }
            }
        }
    ]
}

値と等しくないカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

次の例では、値と等しくないカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示します。値が Canada と等しくない AppCountry という名前のカスタムセキュリティ属性を持つユーザーを取得します。フィルター値は大文字と小文字が区別されます。要求またはヘッダーに ConsistencyLevel=eventual を追加する必要があります。要求が正しくルーティングされるようにするには、 $count=true も含める必要があります。

属性セット: Marketing
属性: AppCountry
フィルター: AppCountry ne 'Canada'

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
--                                   -----------              ------------------------
22cc22cc-dd33-ee44-ff55-66aa66aa66aa Chandra                  Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
44ee44ee-ff55-aa66-bb77-88cc88cc88cc Isabella                 Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
00aa00aa-bb11-cc22-dd33-44ee44ee44ee Alain                    Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
33dd33dd-ee44-ff55-aa66-77bb77bb77bb Joe                      Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue
00aa00aa-bb11-cc22-dd33-44ee44ee44ee Dara                     Microsoft.Graph.PowerShell.Models.MicrosoftGraphCustomSecurityAttributeValue

ユーザーの一覧表示

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": "22cc22cc-dd33-ee44-ff55-66aa66aa66aa",
            "displayName": "Chandra",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "EmployeeId": "GS36348"
                }
            }
        },
        {
            "id": "44ee44ee-ff55-aa66-bb77-88cc88cc88cc",
            "displayName": "Isabella",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "France"
                    ]
                }
            }
        },
        {
            "id": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
            "displayName": "Alain",
            "customSecurityAttributes": {
                "Marketing": {
                    "@odata.type": "#microsoft.graph.customSecurityAttributeValue",
                    "AppCountry@odata.type": "#Collection(String)",
                    "AppCountry": [
                        "Germany",
                        "Japan"
                    ]
                }
            }
        },
        {
            "id": "33dd33dd-ee44-ff55-aa66-77bb77bb77bb",
            "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": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
            "displayName": "Dara",
            "customSecurityAttributes": null
        }
    ]
}

ユーザーから単一値のカスタムセキュリティ属性の割り当てを削除する

次の例では、値を null に設定することによって、ユーザーから単一値のカスタムセキュリティ属性の割り当てを削除します。

属性セット: Engineering
属性: ProjectDate
属性値: null

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

ユーザーの更新

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

ユーザーから複数値のカスタムセキュリティ属性の割り当てを削除する

次の例では、値を空のコレクションに設定することによって、ユーザーから複数値のカスタムセキュリティ属性の割り当てを削除します。

属性セット: Engineering
属性: Project
属性値: []

Update-MgUser

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

ユーザーの更新

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

よく寄せられる質問

ユーザーのカスタムセキュリティ属性の割り当てはどこでサポートされていますか。

ユーザーのカスタムセキュリティ属性の割り当ては、Microsoft Entra 管理センター、PowerShell、Microsoft Graph API でサポートされています。カスタムセキュリティ属性の割り当ては、マイアプリおよび Microsoft 365 管理センターではサポートされていません。

ユーザーに割り当てられているカスタムセキュリティ属性は誰が表示できますか。

テナント内の任意のユーザーに割り当てられたカスタムセキュリティ属性を表示できるのは、テナントスコープで属性割り当て管理者ロールまたは属性割り当て閲覧者ロールが割り当てられているユーザーだけです。ユーザーは、自分のプロファイルまたは他のユーザーに割り当てられたカスタムセキュリティ属性を表示できません。テナントに設定されているゲストのアクセス許可に関係なく、ゲストはカスタムセキュリティ属性を表示できません。

カスタムセキュリティ属性の割り当てを追加するのに、アプリを作成する必要がありますか。

いいえ。カスタムセキュリティ属性は、アプリケーションを必要とせずにユーザーオブジェクトに割り当てることができます。

カスタムセキュリティ属性の割り当てを保存しようとするとエラーが発生し続けるのはなぜですか。

カスタムセキュリティ属性をユーザーに割り当てるアクセス許可がありません。属性割り当て管理者ロールが割り当てられている必要があります。

ゲストにカスタムセキュリティ属性を割り当てることはできますか。

はい。カスタムセキュリティ属性は、テナント内のメンバーまたはゲストに割り当てることができます。

ディレクトリ同期済みのユーザーにカスタムセキュリティ属性を割り当てることはできますか。

はい。オンプレミスの Active Directory のディレクトリ同期済みのユーザーにカスタムセキュリティ属性を割り当てることができます。

動的メンバーシップルールでは、カスタムセキュリティ属性の割り当てを使用することができますか。

いいえ。動的メンバーシップルールの構成では、ユーザーに割り当てられたカスタムセキュリティ属性はサポートされていません。

カスタムセキュリティ属性は B2C テナントのカスタム属性と同じですか。

いいえ。B2C テナントではカスタムセキュリティ属性はサポートされていません。また、カスタムセキュリティ属性はB2C 機能には関連付けされていません。

次の方法で共有

ユーザーのカスタムセキュリティ属性の割り当て、更新、一覧表示、削除

前提条件

カスタムセキュリティ属性のユーザーへの割り当て

ユーザーのカスタムセキュリティ属性の割り当て値を更新する

カスタムセキュリティ属性割り当てに基づいてユーザーをフィルター処理する

ユーザーからカスタムセキュリティ属性の割り当てを削除する

PowerShell または Microsoft Graph API

文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

複数の文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

複数の整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

ブール値を持つカスタムセキュリティ属性をユーザーに割り当てる

ユーザーの整数値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーのブール値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーの複数文字列値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーからカスタムセキュリティ属性の割り当てを取得する

値と等しいカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値で始まるカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値と等しくないカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

ユーザーから単一値のカスタムセキュリティ属性の割り当てを削除する

ユーザーから複数値のカスタムセキュリティ属性の割り当てを削除する

よく寄せられる質問

次のステップ

フィードバック

フィードバック

その他のリソース

次の方法で共有

ユーザーのカスタム セキュリティ属性の割り当て、更新、一覧表示、削除

前提条件

カスタム セキュリティ属性のユーザーへの割り当て

ユーザーのカスタム セキュリティ属性の割り当て値を更新する

カスタム セキュリティ属性割り当てに基づいてユーザーをフィルター処理する

ユーザーからカスタム セキュリティ属性の割り当てを削除する

PowerShell または Microsoft Graph API

文字列値を持つカスタム セキュリティ属性をユーザーに割り当てる

複数の文字列値を持つカスタム セキュリティ属性をユーザーに割り当てる

整数値を持つカスタム セキュリティ属性をユーザーに割り当てる

複数の整数値を持つカスタム セキュリティ属性をユーザーに割り当てる

ブール値を持つカスタム セキュリティ属性をユーザーに割り当てる

ユーザーの整数値を持つカスタム セキュリティ属性割り当てを更新する

ユーザーのブール値を持つカスタム セキュリティ属性割り当てを更新する

ユーザーの複数文字列値を持つカスタム セキュリティ属性割り当てを更新する

ユーザーからカスタム セキュリティ属性の割り当てを取得する

値と等しいカスタム セキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値で始まるカスタム セキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値と等しくないカスタム セキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

ユーザーから単一値のカスタム セキュリティ属性の割り当てを削除する

ユーザーから複数値のカスタム セキュリティ属性の割り当てを削除する

よく寄せられる質問

次のステップ

フィードバック

フィードバック

その他のリソース

ユーザーのカスタムセキュリティ属性の割り当て、更新、一覧表示、削除

カスタムセキュリティ属性のユーザーへの割り当て

ユーザーのカスタムセキュリティ属性の割り当て値を更新する

カスタムセキュリティ属性割り当てに基づいてユーザーをフィルター処理する

ユーザーからカスタムセキュリティ属性の割り当てを削除する

文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

複数の文字列値を持つカスタムセキュリティ属性をユーザーに割り当てる

整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

複数の整数値を持つカスタムセキュリティ属性をユーザーに割り当てる

ブール値を持つカスタムセキュリティ属性をユーザーに割り当てる

ユーザーの整数値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーのブール値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーの複数文字列値を持つカスタムセキュリティ属性割り当てを更新する

ユーザーからカスタムセキュリティ属性の割り当てを取得する

値と等しいカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値で始まるカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

値と等しくないカスタムセキュリティ属性の割り当てを持つすべてのユーザーを一覧表示する

ユーザーから単一値のカスタムセキュリティ属性の割り当てを削除する

ユーザーから複数値のカスタムセキュリティ属性の割り当てを削除する