New-EntraBetaCustomSecurityAttributeDefinition

New-EntraBetaCustomSecurityAttributeDefinition

    -IsSearchable <Boolean>
    -IsCollection <Boolean>
    -AttributeSet <String>
    -Type <String>
    -Name <String>
    -Status <String>
    -UsePreDefinedValuesOnly <Boolean>
    [-Description <String>]
    [<CommonParameters>]

指令 New-EntraBetaCustomSecurityAttributeDefinition 長會建立一個新的 customSecurityAttributeDefinition 物件。 請指定 IsSearchable、 IsCollection、 AttributeSet、 StatusTypeNameUsePreDefinedValuesOnly 及 參數，以建立新的自訂安全屬性定義。

你可以在租戶中定義最多 500 個活躍物件。

登入使用者必須被指派以下目錄角色之一：

• 屬性定義管理員

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeSet = Get-EntraAttributeSet -Id 'ContosoSet'
$params = @{
    Name                    = 'ProjectTest'
    Description             = 'Target completion'
    Type                    = 'String'
    Status                  = 'Available'
    AttributeSet            = $attributeSet.Id
    IsCollection            = $False
    IsSearchable            = $True
    UsePreDefinedValuesOnly = $True
}
New-EntraBetaCustomSecurityAttributeDefinition @params

Id               AttributeSet Description       IsCollection IsSearchable Name        Status    Type   UsePreDefinedValuesOnly
--               ------------ -----------       ------------ ------------ ----        ------    ----   -----------------------
Test_ProjectTest Test         Target completion False        True         ProjectTest Available String False

此範例示範如何新增自訂安全屬性。

• -Name 參數指定自訂安全屬性的名稱。
• -Description 參數指定自訂安全屬性的描述。
• -Type 參數指定自訂安全屬性值的資料型態。
• -Status 參數 指定自訂安全屬性為啟用或停用。
• -AttributeSet 參數指定屬性集合的名稱。
• -IsCollection 參數指定允許多個值可被指派給自訂安全屬性。
• -IsSearchable 參數指定了自訂安全屬性值被索引以供物件搜尋。
• -UsePreDefinedValuesOnly 參數指定只能指派於自訂安全屬性的預先定義值。

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