Microsoft Entra ID でカスタムセキュリティ属性の定義を追加または非アクティブ化する

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

Microsoft Entra ID のカスタムセキュリティ属性は、ビジネス固有の属性 (キーと値のペア) であり、Microsoft Entra のオブジェクトに対して定義し割り当てることができます。この記事では、カスタムセキュリティ属性の定義を追加、編集、または非アクティブ化する方法について説明します。

前提条件

カスタムセキュリティ属性の定義を追加または非アクティブ化するには、次が必要です。

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

重要

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

属性セットを追加する

ヒント

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

属性セットは、関連する属性のコレクションです。すべてのカスタムセキュリティ属性は、属性セットの一部である必要があります。属性セットの名前を変更または削除することはできません。

Microsoft Entra 管理センターに属性定義管理者としてサインインします。
[保護]>[カスタムセキュリティ属性] を参照します。
[Add attribute set](属性セットの追加) をクリックして、新しい属性セットを追加します。

[Add attribute set] (属性セットの追加) が無効になっている場合は、属性定義管理者のロールが割り当てられていることを確認してください。詳細については、カスタムセキュリティ属性のトラブルシューティングに関する記事を参照してください。
属性の名前、説明、最大数を入力します。

属性セット名には、スペースや特殊文字を含めない 32 文字を指定できます。一度指定した名前は、変更できません。詳細については、「制限および制約」を参照してください。
作業が終了したら、 [追加] をクリックします。

新しい属性セットが属性セットの一覧に表示されます。

カスタムセキュリティ属性の定義を追加する

Microsoft Entra 管理センターに属性定義管理者としてサインインします。
[保護]>[カスタムセキュリティ属性] を参照します。
[カスタムセキュリティ属性] ページで、既存の属性セットを見つけるか、[Add attribute set](属性セットの追加) をクリックして新しい属性セットを追加します。

すべてのカスタムセキュリティ属性の定義は、属性セットに属している必要があります。
クリックして、選択した属性セットを開きます。
[属性の追加] をクリックして、新しいカスタムセキュリティ属性をその属性セットに追加します。
[属性名] ボックスに、カスタムセキュリティ属性名を入力します。

カスタムセキュリティ属性名には、スペースや特殊文字を含めない 32 文字を指定できます。一度指定した名前は、変更できません。詳細については、「制限および制約」を参照してください。
[説明] ボックスに、説明 (省略可能) を入力します。

説明は 128 文字まで入力できます。必要に応じて、後で説明を変更できます。
[データ型] の一覧から、カスタムセキュリティ属性のデータ型を選択します。

データ型説明

Boolean true、True、false、False のいずれかの値をとるブール値。

整数型 32 ビットの整数。

String 文字数を指定できる文字列。
[Allow multiple values to be assigned](複数の値の割り当てを許可する) で、[はい] または [いいえ] を選択します。

[はい] を選択すると、このカスタムセキュリティ属性に複数の値を割り当てることができます。 [いいえ] を選択すると、このカスタムセキュリティ属性に単一の値のみを割り当てることができます。
[Only allow predefined values to be assigned](定義済みの値のみの割り当てを許可する) で、[はい] または [いいえ] を選択します。

定義済みの値の一覧からこのカスタムセキュリティ属性に値を割り当てる場合は、[はい] を選択します。 [いいえ] を選択すると、ユーザー定義の値または潜在的に定義済みの値をこのカスタムセキュリティ属性に割り当てることができます。
[Only allow predefined values to be assigned](定義済みの値のみの割り当てを許可する) が [はい] の場合は、[値の追加] をクリックして定義済みの値を追加します。

アクティブな値は、オブジェクトへの割り当てに使用できます。アクティブでない値は定義されますが、割り当てにはまだ使用できません。
完了したら、 [保存] をクリックします。

新しいカスタムセキュリティ属性は、カスタムセキュリティ属性の一覧に表示されます。
定義済みの値を含める場合は、次のセクションの手順に従います。

データ型	説明
Boolean	true、True、false、False のいずれかの値をとるブール値。
整数型	32 ビットの整数。
String	文字数を指定できる文字列。

カスタムセキュリティ属性の定義を編集する

新しいカスタムセキュリティ属性の定義を追加したら、後でいくつかのプロパティを編集できます。一部のプロパティは不変であり、変更することはできません。

Microsoft Entra 管理センターに属性定義管理者としてサインインします。
[保護]>[カスタムセキュリティ属性] を参照します。
編集するカスタムセキュリティ属性を含む属性セットをクリックします。
カスタムセキュリティ属性の一覧で、編集したいカスタムセキュリティ属性の省略記号をクリックし、[属性の編集] を選択します。
有効になっているプロパティを編集します。
[Only allow predefined values to be assigned](定義済みの値のみの割り当てを許可する) が [はい] の場合は、[値の追加] をクリックして定義済みの値を追加します。既存の定義済みの値をクリックして、[Is active?]\[アクティブですか?\] 設定を変更します。

カスタムセキュリティ属性の定義を非アクティブ化する

カスタムセキュリティ属性の定義を追加したら、それを削除できます。ただし、カスタムセキュリティ属性の定義を非アクティブ化できます。

Microsoft Entra 管理センターに属性定義管理者としてサインインします。
[保護]>[カスタムセキュリティ属性] を参照します。
非アクティブ化するカスタムセキュリティ属性を含む属性セットをクリックします。
カスタムセキュリティ属性の一覧で、非アクティブ化するカスタムセキュリティ属性の横にチェックマークを追加します。
[Deactivate attribute](属性の非アクティブ化) をクリックします。
表示される [Deactivate attribute] (属性の非アクティブ化) ダイアログで、[はい] をクリックします。

カスタムセキュリティ属性が非アクティブ化され、非アクティブ化された属性の一覧に移動します。

PowerShell または Microsoft Graph API

Microsoft Entra 組織内のカスタムセキュリティ属性の定義を管理するには、PowerShell または Microsoft Graph API を使用することもできます。次の例では、属性セットとカスタムセキュリティ属性の定義を管理します。

すべての属性セットを取得する

次の例では、すべての属性セットを取得します。

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {}

Description          : Attributes for marketing team
Id                   : Marketing
MaxAttributesPerSet  : 25
AdditionalProperties : {}

attributeSets を一覧表示する

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

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet

上位の属性セットを取得する

次の例では、上位の属性セットを取得します。

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Top 10

attributeSets を一覧表示する

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

属性セットを順番に取得する

次の例では、属性セットを順番に取得します。

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -Sort "Id"

attributeSets を一覧表示する

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

属性セットを取得する

次の例では、属性セットを取得します。

属性セット: Engineering

Get-MgDirectoryAttributeSet

Get-MgDirectoryAttributeSet -AttributeSetId "Engineering" | Format-List

Description          : Attributes for engineering team
Id                   : Engineering
MaxAttributesPerSet  : 25
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/attributeSets/$entity]}

attributeSet を取得する

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

Get-AzureADMSAttributeSet

Get-AzureADMSAttributeSet -Id "Engineering"

属性セットを追加する

次の例では、新しい属性セットを追加します。

属性セット: Engineering

New-MgDirectoryAttributeSet

$params = @{
    Id = "Engineering"
    Description = "Attributes for engineering team"
    MaxAttributesPerSet = 25
}
New-MgDirectoryAttributeSet -BodyParameter $params

Id          Description                     MaxAttributesPerSet
--          -----------                     -------------------
Engineering Attributes for engineering team 25

attributeSet を作成する

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

New-AzureADMSAttributeSet

New-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for engineering team" -MaxAttributesPerSet 10

属性セットを更新する

次の例では、属性セットを更新します。

属性セット: Engineering

Update-MgDirectoryAttributeSet

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

attributeSet を更新する

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

Set-AzureADMSAttributeSet

Set-AzureADMSAttributeSet -Id "Engineering" -Description "Attributes for cloud engineering team"
Set-AzureADMSAttributeSet -Id "Engineering" -MaxAttributesPerSet 20

すべてのカスタムセキュリティ属性の定義を取得する

次の例では、すべてのカスタムセキュリティ属性の定義を取得します。

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Marketing
Description             : Country where is application is used
Id                      : Marketing_AppCountry
IsCollection            : True
IsSearchable            : True
Name                    : AppCountry
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

customSecurityAttributeDefinitions を一覧表示する

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

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition

カスタムセキュリティ属性の定義をフィルターする

次の例では、カスタムセキュリティ属性の定義をフィルターします。

フィルター: 属性名が 'Project' で状態が 'Available'

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "name eq 'Project' and status eq 'Available'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

customSecurityAttributeDefinitions を一覧表示する

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

フィルター: 属性セットが 'Engineering' で状態が 'Available'、データ型が 'String'

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -Filter "attributeSet eq 'Engineering' and status eq 'Available' and type eq 'String'" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {}

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {}

customSecurityAttributeDefinitions を一覧表示する

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

カスタムセキュリティ属性の定義を取得する

次の例では、カスタムセキュリティ属性の定義を取得します。

属性セット: Engineering
属性: ProjectDate

Get-MgDirectoryCustomSecurityAttributeDefinition

Get-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

customSecurityAttributeDefinition を取得する

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

Get-AzureADMSCustomSecurityAttributeDefinition

Get-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate"

カスタムセキュリティ属性の定義を追加する

次の例では、新しいカスタムセキュリティ属性の定義を追加します。

属性セット: Engineering
属性: ProjectDate
属性のデータ型: 文字列

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Target completion date"
    isCollection = $false
    isSearchable = $true
    name = "ProjectDate"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $false
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Target completion date
Id                      : Engineering_ProjectDate
IsCollection            : False
IsSearchable            : True
Name                    : ProjectDate
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : False
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

customSecurityAttributeDefinition を作成する

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Target completion date",
    "isCollection":false,
    "isSearchable":true,
    "name":"ProjectDate",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": false
}

New-AzureADMSCustomSecurityAttributeDefinition

New-AzureADMSCustomSecurityAttributeDefinition -AttributeSet "Engineering" -Name "ProjectDate" -Description "Target completion date" -Type "String" -Status "Available" -IsCollection $false -IsSearchable $true -UsePreDefinedValuesOnly $false

複数の定義済みの値をサポートするカスタムセキュリティ属性の定義を追加する

次の例では、複数の定義済みの値をサポートする新しいカスタムセキュリティ属性の定義を追加します。

属性セット: Engineering
属性: Project
属性のデータ型: 文字列のコレクション

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

customSecurityAttributeDefinition を作成する

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet":"Engineering",
    "description":"Active projects for user",
    "isCollection":true,
    "isSearchable":true,
    "name":"Project",
    "status":"Available",
    "type":"String",
    "usePreDefinedValuesOnly": true
}

定義済みの値の一覧を含むカスタムセキュリティ属性の定義を追加する

次の例では、定義済みの値の一覧を含む新しいカスタムセキュリティ属性の定義を追加します。

属性セット: Engineering
属性: Project
属性のデータ型: 文字列のコレクション
定義済みの値: Alpine、Baker、Cascade

New-MgDirectoryCustomSecurityAttributeDefinition

$params = @{
    attributeSet = "Engineering"
    description = "Active projects for user"
    isCollection = $true
    isSearchable = $true
    name = "Project"
    status = "Available"
    type = "String"
    usePreDefinedValuesOnly = $true
    allowedValues = @(
        @{
            id = "Alpine"
            isActive = $true
        }
        @{
            id = "Baker"
            isActive = $true
        }
        @{
            id = "Cascade"
            isActive = $true
        }
    )
}
New-MgDirectoryCustomSecurityAttributeDefinition -BodyParameter $params | Format-List

AllowedValues           :
AttributeSet            : Engineering
Description             : Active projects for user
Id                      : Engineering_Project
IsCollection            : True
IsSearchable            : True
Name                    : Project
Status                  : Available
Type                    : String
UsePreDefinedValuesOnly : True
AdditionalProperties    : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions/$entity]}

customSecurityAttributeDefinition を作成する

POST https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions
{
    "attributeSet": "Engineering",
    "description": "Active projects for user",
    "isCollection": true,
    "isSearchable": true,
    "name": "Project",
    "status": "Available",
    "type": "String",
    "usePreDefinedValuesOnly": true,
    "allowedValues": [
        {
            "id": "Alpine",
            "isActive": true
        },
        {
            "id": "Baker",
            "isActive": true
        },
        {
            "id": "Cascade",
            "isActive": true
        }
    ]
}

カスタムセキュリティ属性の定義を更新する

次の例では、カスタムセキュリティ属性の定義を更新します。

属性セット: Engineering
属性: ProjectDate

Update-MgDirectoryCustomSecurityAttributeDefinition

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

customSecurityAttributeDefinition を更新する

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

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_ProjectDate" -Description "Target completion date (YYYY/MM/DD)"

カスタムセキュリティ属性の定義の定義済みの値を更新する

次の例では、カスタムセキュリティ属性の定義の定義済みの値を更新します。

属性セット: Engineering
属性: Project
属性のデータ型: 文字列のコレクション
定義済みの値の更新: Baker
新しい定義済みの値: Skagit

Invoke-MgGraphRequest

Note

この要求では、OData-Version ヘッダーを追加し、値 4.01 を割り当てる必要があります。

$params = @{
    "allowedValues@delta" = @(
        @{
            id = "Baker"
            isActive = $false
        }
        @{
            id = "Skagit"
            isActive = $true
        }
    )
}
$header = @{
    "OData-Version" = 4.01
}
Invoke-MgGraphRequest -Method PATCH -Uri "https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project5" -Headers $header -Body $params

customSecurityAttributeDefinition を更新する

Note

この要求では、OData-Version ヘッダーを追加し、値 4.01 を割り当てる必要があります。

PATCH https://graph.microsoft.com/v1.0/directory/customSecurityAttributeDefinitions/Engineering_Project
{
    "allowedValues@delta": [
        {
            "id": "Baker",
            "isActive": false
        },
        {
            "id": "Skagit",
            "isActive": true
        }
    ]
}

カスタムセキュリティ属性の定義を非アクティブ化する

次の例では、カスタムセキュリティ属性の定義を非アクティブ化します。

属性セット: Engineering
属性: Project

Update-MgDirectoryCustomSecurityAttributeDefinition

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

customSecurityAttributeDefinition を更新する

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

Set-AzureADMSCustomSecurityAttributeDefinition

Set-AzureADMSCustomSecurityAttributeDefinition -Id "Engineering_Project" -Status "Deprecated"

すべての定義済みの値を取得する

次の例では、カスタムセキュリティ属性の定義のすべての定義済みの値を取得します。

属性セット: Engineering
属性: Project

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" | Format-List

Id                   : Skagit
IsActive             : True
AdditionalProperties : {}

Id                   : Baker
IsActive             : False
AdditionalProperties : {}

Id                   : Cascade
IsActive             : True
AdditionalProperties : {}

Id                   : Alpine
IsActive             : True
AdditionalProperties : {}

allowedValues を一覧表示する

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

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project"

定義済みの値を取得する

次の例では、カスタムセキュリティ属性の定義の定義済みの値を取得します。

属性セット: Engineering
属性: Project
定義済みの値: Alpine

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

Get-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

allowedValue を取得する

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

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Get-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine"

定義済みの値を追加する

次の例では、カスタムセキュリティ属性の定義の定義済みの値を追加します。

usePreDefinedValuesOnly が true に設定されているカスタムセキュリティ属性には、定義済みの値を追加することができます。

属性セット: Engineering
属性: Project
定義済みの値: Alpine

New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

$params = @{
    id = "Alpine"
    isActive = $true
}
New-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -BodyParameter $params | Format-List

Id                   : Alpine
IsActive             : True
AdditionalProperties : {[@odata.context, https://graph.microsoft.com/v1.0/$metadata#directory/customSecurityAttributeDefinitions('Engineering_Project')/al
                       lowedValues/$entity]}

allowedValue を作成する

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

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues

Add-AzureADMScustomSecurityAttributeDefinitionAllowedValues -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $true

定義済みの値を非アクティブ化する

次の例では、カスタムセキュリティ属性の定義の定義済みの値を非アクティブ化します。

属性セット: Engineering
属性: Project
定義済みの値: Alpine

Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue

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

allowedValue を更新する

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

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue

Set-AzureADMSCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -Id "Alpine" -IsActive $false

よく寄せられる質問

カスタムセキュリティ属性の定義を削除できますか?

いいえ、カスタムセキュリティ属性の定義を削除することはできません。カスタムセキュリティ属性の定義を非アクティブ化することのみが可能です。カスタムセキュリティ属性を非アクティブ化すると、Microsoft Entra オブジェクトに適用できなくなります。非アクティブ化されたカスタムセキュリティ属性の定義に対するカスタムセキュリティ属性の割り当ては、自動的には削除されません。非アクティブ化されるカスタムセキュリティ属性の数に制限はありません。テナントごとに 500 のアクティブなカスタムセキュリティ属性の定義を設定でき、カスタムセキュリティ属性の定義あたり 100 の定義済みの値を許可できます。

Microsoft Entra ID でカスタムセキュリティ属性の定義を追加または非アクティブ化する

前提条件

属性セットを追加する

カスタムセキュリティ属性の定義を追加する

カスタムセキュリティ属性の定義を編集する

カスタムセキュリティ属性の定義を非アクティブ化する

PowerShell または Microsoft Graph API

すべての属性セットを取得する

上位の属性セットを取得する

属性セットを順番に取得する

属性セットを取得する

属性セットを追加する

属性セットを更新する

すべてのカスタムセキュリティ属性の定義を取得する

カスタムセキュリティ属性の定義をフィルターする

カスタムセキュリティ属性の定義を取得する

カスタムセキュリティ属性の定義を追加する

複数の定義済みの値をサポートするカスタムセキュリティ属性の定義を追加する

定義済みの値の一覧を含むカスタムセキュリティ属性の定義を追加する

カスタムセキュリティ属性の定義を更新する

カスタムセキュリティ属性の定義の定義済みの値を更新する

カスタムセキュリティ属性の定義を非アクティブ化する

すべての定義済みの値を取得する

定義済みの値を取得する

定義済みの値を追加する

定義済みの値を非アクティブ化する

よく寄せられる質問

次のステップ

その他のリソース

Microsoft Entra ID でカスタム セキュリティ属性の定義を追加または非アクティブ化する

前提条件

属性セットを追加する

カスタム セキュリティ属性の定義を追加する

カスタム セキュリティ属性の定義を編集する

カスタム セキュリティ属性の定義を非アクティブ化する

PowerShell または Microsoft Graph API

すべての属性セットを取得する

上位の属性セットを取得する

属性セットを順番に取得する

属性セットを取得する

属性セットを追加する

属性セットを更新する

すべてのカスタム セキュリティ属性の定義を取得する

カスタム セキュリティ属性の定義をフィルターする

カスタム セキュリティ属性の定義を取得する

カスタム セキュリティ属性の定義を追加する

複数の定義済みの値をサポートするカスタム セキュリティ属性の定義を追加する

定義済みの値の一覧を含むカスタム セキュリティ属性の定義を追加する

カスタム セキュリティ属性の定義を更新する

カスタム セキュリティ属性の定義の定義済みの値を更新する

カスタム セキュリティ属性の定義を非アクティブ化する

すべての定義済みの値を取得する

定義済みの値を取得する

定義済みの値を追加する

定義済みの値を非アクティブ化する

よく寄せられる質問

次のステップ

その他のリソース

Microsoft Entra ID でカスタムセキュリティ属性の定義を追加または非アクティブ化する

カスタムセキュリティ属性の定義を追加する

カスタムセキュリティ属性の定義を編集する

カスタムセキュリティ属性の定義を非アクティブ化する

すべてのカスタムセキュリティ属性の定義を取得する

カスタムセキュリティ属性の定義をフィルターする

カスタムセキュリティ属性の定義を取得する

カスタムセキュリティ属性の定義を追加する

複数の定義済みの値をサポートするカスタムセキュリティ属性の定義を追加する

定義済みの値の一覧を含むカスタムセキュリティ属性の定義を追加する

カスタムセキュリティ属性の定義を更新する

カスタムセキュリティ属性の定義の定義済みの値を更新する

カスタムセキュリティ属性の定義を非アクティブ化する