Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

模組:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

新增一個預設的自訂安全屬性定義值。

語法

Default (預設值) 

Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

    -IsActive <Boolean>
    -CustomSecurityAttributeDefinitionId <String>
    -Id <String>
    [<CommonParameters>]

Description

它Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue會為 Microsoft Entra ID 自訂安全屬性定義加入預設值。

在委託工作或學校帳號的情境中，登入使用者必須擁有支援的 Microsoft Entra 角色或具備必要權限的自訂角色。 以下可使用的最低權限角色：

  • 屬性定義管理員

範例

範例 1：為 Microsoft Entra ID 自訂安全屬性定義新增預設值

Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object { $_.Name -eq 'Engineering' }
Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id -Id 'Alpine' -IsActive $true

Id   IsActive
--   --------
Alpine True

此範例為自訂安全屬性定義加入預定義值。

  • -CustomSecurityAttributeDefinitionId 參數指定自訂的安全屬性定義 ID。 你可以用這個指令 Get-EntraBetaCustomSecurityAttributeDefinition 取得ID。
  • -Id 參數指定預定義值的識別碼。
  • -IsActive 參數 指定預設值為有效或停用。

參數

-CustomSecurityAttributeDefinitionId

Microsoft Entra ID 中自訂安全屬性定義的唯一識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Id

預設值的唯一識別碼，長度可達 64 個字元，並包含 Unicode 字元。 空格是允許的，但某些特殊字元不行。 此識別碼區分大小寫，無法後續更改，且是必填的。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IsActive

顯示預設值是啟用還是停用。 若設為 false，則此預設值無法指派給其他支援的目錄物件。

參數屬性

類型:System.Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

System.String

輸出

System.Object

備註

Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValues 是 Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue 的別名。