Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue
获取自定义安全属性定义的预定义值。
语法
GetQuery (默认值)
Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue
-CustomSecurityAttributeDefinitionId <String>
[-Filter <String>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue
-CustomSecurityAttributeDefinitionId <String>
-Id <String>
[-Property <String[]>]
[<CommonParameters>]
说明
获取Microsoft Entra ID自定义安全属性定义的预定义值。 指定 CustomSecurityAttributeDefinitionId 参数以检索预定义值自定义安全属性定义。
必须为已登录用户分配以下目录角色之一:
- 属性定义读取器
- 属性定义管理员
示例
示例 1:获取所有预定义值
Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object {$_.Name -eq 'Engineering'}
Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id
Id IsActive
-- --------
Apline True
此示例检索所有预定义值。
-
-CustomSecurityAttributeDefinitionId参数指定自定义安全属性定义 ID。 可用于Get-EntraBetaCustomSecurityAttributeDefinition获取此值。
示例 2:获取 ID 参数的预定义值
Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object {$_.Name -eq 'Engineering'}
Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id -Id 'Alpine'
Id IsActive
-- --------
Apline True
此示例检索特定的预定义值。
-
-CustomSecurityAttributeDefinitionId参数指定自定义安全属性定义 ID。 可用于Get-EntraBetaCustomSecurityAttributeDefinition获取此值。 -
-Id参数指定 Microsoft Entra ID 对象的 ID。
示例 3:使用 Filter 参数获取预定义值
Connect-Entra -Scopes 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object {$_.Name -eq 'Engineering'}
Get-EntraBetaCustomSecurityAttributeDefinitionAllowedValue -CustomSecurityAttributeDefinitionId $attributeDefinition.Id -Filter "Id eq 'Alpine'"
Id IsActive
-- --------
Apline True
此示例检索包含具有指定值的 ID 的预定义值。
-
-CustomSecurityAttributeDefinitionId参数指定自定义安全属性定义 ID。 可用于Get-EntraBetaCustomSecurityAttributeDefinition获取此值。
参数
-CustomSecurityAttributeDefinitionId
customSecurityAttributeDefinition 的唯一标识符。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Filter
按属性值筛选项。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetQuery
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Id
预定义值的唯一标识符,长度可达 64 个字符,并且包含 Unicode 字符。 允许空格,但某些特殊字符不是。 此标识符区分大小写,以后无法更改,并且是必需的。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
GetById
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Property
指定要返回的属性
参数属性
| 类型: | System.String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Select |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。