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、 Type、 Name、 Status 、および UsePreDefinedValuesOnly パラメーターを指定します。

テナントには、最大 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 パラメーターは、カスタム セキュリティ属性に割り当てることができる定義済みの値のみを指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。