Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

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

为自定义安全属性定义添加预定义值。

语法

Default (默认值) 

Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValue

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

说明

为Add-EntraBetaCustomSecurityAttributeDefinitionAllowedValueMicrosoft 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 的别名。