在 Microsoft Entra ID 中新增或停用自定義安全性屬性定義
Microsoft Entra ID 中的自訂安全性屬性 是商務特定的屬性(索引鍵/值對),您可以定義並指派給 Microsoft Entra 物件。 本文說明如何新增、編輯或停用自定義安全性屬性定義。
先決條件
若要新增或停用自定義安全性屬性定義,您必須具備:
- 屬性定義系統管理員
- Microsoft.Graph 模組在使用 Microsoft Graph PowerShell 時
- 使用 Azure AD PowerShell 時,需選擇 AzureADPreview 2.0.2.138 版或更新的版本
重要
根據預設,全域管理員 和其他系統管理員角色沒有讀取、定義或指派自定義安全性屬性的許可權。
新增屬性集
提示
本文中的步驟可能會根據您開始使用的入口稍有不同。
屬性集是相關屬性的集合。 所有自訂安全性屬性都必須是屬性集的一部分。 無法重新命名或刪除屬性集。
以
屬性定義系統管理員身分登入 。Microsoft Entra 系統管理中心 瀏覽至 Protection>自訂安全性屬性。
選取 新增屬性集 以新增屬性集。
如果 [新增屬性集] 已停用,請確定您已獲指派 [屬性定義管理員] 角色。 如需詳細資訊,請參閱 自定義安全性屬性疑難解答。
輸入名稱、描述和屬性數目上限。
屬性集名稱可以是 32 個字元,不含空格或特殊字元。 指定名稱之後,就無法重新命名它。 如需詳細資訊,請參閱 限制和條件約束。
完成後,選取 新增。
新的屬性集會出現在屬性集清單中。
新增自訂安全性屬性定義
以 屬性定義系統管理員的身份登入 Microsoft Entra 系統管理中心。
瀏覽至 Protection>自訂安全性屬性。
在 [自定義安全性屬性] 頁面上,尋找現有的屬性集,或選取 [[新增屬性集] 以新增屬性集。
所有自訂安全性屬性定義都必須是屬性集的一部分。
選取以開啟選取的屬性集。
選取 [新增屬性],將新的自訂安全性屬性新增至屬性集。
在 [屬性名稱] 方塊中,輸入自定義安全性屬性名稱。
自定義安全性屬性名稱可以是 32 個字元,沒有空格或特殊字元。 指定名稱之後,就無法重新命名它。 如需詳細資訊,請參閱 限制和條件約束。
在 [描述] 方塊中,輸入選擇性描述。
描述長度可以是 128 個字元。 如有必要,您可以稍後變更描述。
從 [數據類型] 清單中,選取自定義安全性屬性的數據類型。
數據類型 描述 布爾 布爾值,可以是 true、True、false 或 False。 整數 32 位整數。 字串 長度為 X 個字元的字串。 針對 允許指派多個值,請選擇 是 或 否。
選取 [[是],以允許將多個值指派給此自定義安全性屬性。 選取 [[否],只允許將單一值指派給此自定義安全性屬性。
針對 [只允許指派預先定義的值],請選取 [是] 或 [否]。
選取 是,以要求必須從預先定義的值列表中分配此自訂安全屬性。 選取 [[否],即可將此自定義安全性屬性指派給使用者定義值或可能預先定義的值。
如果 只有允許指派預先定義的值 是 是,請選取 新增值 ,以新增預先定義的值。
可被使用的值可用於指派給物件。 尚未啟用的值已被定義,但尚未可用於指派。
完成時,請選擇 儲存。
新的自訂安全性屬性會出現在自定義安全性屬性清單中。
如果您想要包含預先定義的值,請遵循下一節中的步驟。
編輯自定義安全性屬性定義
新增自訂安全性屬性定義之後,您可以稍後編輯一些屬性。 某些屬性是不可變的,無法變更。
以
屬性定義系統管理員身分登入 。Microsoft Entra 系統管理中心 瀏覽至 Protection>自訂安全性屬性。
選取包含您要編輯之自訂安全性屬性的屬性集。
在自訂安全性屬性的清單中,選取您要編輯的自訂安全性屬性旁的省略號,然後選取 編輯屬性。
編輯已啟用的屬性。
如果 [僅允許指派預先定義的值][是],請選取 [[新增值] 以新增預先定義的值。 選取現有的預先定義值,以變更使用中 ? 設定。
停用自定義安全性屬性定義
新增自定義安全性屬性定義之後,就無法將其刪除。 不過,您可以停用自定義安全性屬性定義。
以 Microsoft Entra 系統管理中心 的 屬性定義系統管理員身分登入。
瀏覽至 保護>自訂安全性屬性。
選取包含您要停用之自定義安全性屬性的屬性集。
在自訂安全屬性清單中,勾選要停用的自訂安全屬性旁的勾選框。
選取 停用屬性。
在出現的 [停用屬性] 對話框中,選取 [是]。
自訂安全性屬性已停用,並移至 [已停用的屬性] 清單。
PowerShell 或 Microsoft Graph API
若要管理 Microsoft Entra 組織中的自訂安全性屬性定義,您也可以使用 PowerShell 或 Microsoft Graph API。 下列範例會管理屬性集和自定義安全性屬性定義。
取得所有屬性集
下列範例會取得所有屬性集。
Get-MgDirectoryAttributeSet | Format-List
Description : Attributes for engineering team
Id : Engineering
MaxAttributesPerSet : 25
AdditionalProperties : {}
Description : Attributes for marketing team
Id : Marketing
MaxAttributesPerSet : 25
AdditionalProperties : {}
取得最上層屬性集
下列範例會取得最佳屬性集。
Get-MgDirectoryAttributeSet -Top 10
依序取得屬性集
下列範例會依序取得屬性集。
Get-MgDirectoryAttributeSet -Sort "Id"
取得屬性集
下列範例會獲取屬性集。
- 屬性集:
Engineering
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]}
新增屬性集
下列範例會新增屬性集。
- 屬性集:
Engineering
$params = @{
Id = "Engineering"
Description = "Attributes for engineering team"
MaxAttributesPerSet = 25
}
New-MgDirectoryAttributeSet -BodyParameter $params
Id Description MaxAttributesPerSet
-- ----------- -------------------
Engineering Attributes for engineering team 25
更新屬性集
下列範例會更新屬性集。
- 屬性集:
Engineering
Update-MgDirectoryAttributeSet
$params = @{
description = "Attributes for engineering team"
maxAttributesPerSet = 20
}
Update-MgDirectoryAttributeSet -AttributeSetId "Engineering" -BodyParameter $params
取得所有自定義安全性屬性定義
下列範例會取得所有自定義安全性屬性定義。
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 : {}
篩選自定義安全性屬性定義
下列範例會篩選自定義安全性屬性定義。
- 篩選:屬性名稱等於 '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 : {}
- 篩選:屬性集 等於 '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 : {}
取得自訂安全性屬性定義
下列範例會取得自定義安全性屬性定義。
- 屬性集:
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]}
新增自訂安全性屬性定義
下列範例會新增新的自定義安全性屬性定義。
- 屬性集:
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]}
新增支援多個預先定義值的自定義安全性屬性定義
下列範例會新增支援多個預先定義值的新自定義安全性屬性定義。
- 屬性集:
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]}
新增具有預先定義值清單的自定義安全性屬性定義
下列範例會新增具有預先定義值清單的新自定義安全性屬性定義。
- 屬性集:
Engineering
- 屬性:
Project
- 屬性數據類型:字串集合
- 預先定義的值:
Alpine
、Baker
、Cascade
$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]}
更新自定義安全性屬性定義
下列範例會更新自定義安全性屬性定義。
- 屬性集:
Engineering
- 屬性:
ProjectDate
Update-MgDirectoryCustomSecurityAttributeDefinition
$params = @{
description = "Target completion date (YYYY/MM/DD)"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params
更新自訂安全性屬性定義的預先定義值
下列範例會更新自定義安全性屬性定義的預先定義值。
- 屬性集:
Engineering
- 屬性:
Project
- 屬性數據類型:字串集合
- 更新預先定義的值:
Baker
- 新的預先定義值:
Skagit
注意
針對此要求,您必須新增 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
停用自定義安全性屬性定義
下列範例會停用自定義安全性屬性定義。
- 屬性集:
Engineering
- 屬性:
Project
Update-MgDirectoryCustomSecurityAttributeDefinition
$params = @{
status = "Deprecated"
}
Update-MgDirectoryCustomSecurityAttributeDefinition -CustomSecurityAttributeDefinitionId "Engineering_ProjectDate" -BodyParameter $params
取得所有預先定義的值
下列範例會取得自定義安全性屬性定義的所有預先定義值。
- 屬性集:
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 : {}
取得預先定義的值
下列範例會取得自定義安全性屬性定義的預先定義值。
- 屬性集:
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]}
新增預先定義的值
下列範例會新增自定義安全性屬性定義的預先定義值。
您可以為 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]}
停用預先定義的值
下列範例會停用自定義安全性屬性定義的預先定義值。
- 屬性集:
Engineering
- 屬性:
Project
- 預先定義的值:
Alpine
Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue
$params = @{
isActive = $false
}
Update-MgDirectoryCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId "Engineering_Project" -AllowedValueId "Alpine" -BodyParameter $params
常見問題
您是否可以刪除自訂安全性屬性定義?
否,您無法刪除自定義安全性屬性定義。 您只能停用 自訂安全性屬性定義。 停用自定義安全性屬性之後,就無法再將它套用至Microsoft Entra 物件。 停用之自定義安全性屬性定義的自定義安全性屬性指派不會自動移除。 停用的自定義安全性屬性數目沒有限制。 每個租使用者可以有 500 個作用中的自訂安全性屬性定義,每個自定義安全性屬性定義允許 100 個預先定義值。
後續步驟
- 管理 Microsoft Entra ID 中自訂安全屬性的存取
- 指派、更新、列出或移除使用者的自訂安全性屬性
- 應用程式 指派、更新、列出或移除自定義安全性屬性