Set-EntraBetaCustomSecurityAttributeDefinition
更新 customSecurityAttributeDefinition 对象的属性。
语法
Default (默认值)
Set-EntraBetaCustomSecurityAttributeDefinition
-Id <String>
[-Description <String>]
[-Status <String>]
[-UsePreDefinedValuesOnly <Boolean>]
[<CommonParameters>]
说明
更新 customSecurityAttributeDefinition 对象的属性。 指定 Id 参数以更新自定义安全属性定义。
必须为已登录用户分配以下目录角色之一：
- 属性定义管理员
示例
示例 1：更新自定义安全属性
Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object { $_.Name -eq 'Engineering' }
Set-EntraBetaCustomSecurityAttributeDefinition -Id $attributeDefinition.Id -Description 'Engineering Description' -Status 'Available' -UsePreDefinedValuesOnly $false
此示例更新自定义安全属性。
-
-Id参数指定自定义安全属性定义对象 ID。 -
-Description参数指定自定义安全属性的说明。 -
-Status参数指定自定义安全属性处于活动状态或已停用。 -
-UsePreDefinedValuesOnly参数指定唯一的预定义值可以分配给自定义安全属性。
参数
-Description
自定义安全属性的说明，最多包含 128 个字符，包括 Unicode 字符。 稍后可以更改此说明。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
Microsoft Entra ID自定义安全属性定义对象的唯一标识符。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Status
指定自定义安全属性是处于活动状态还是已停用状态。 可接受的值为：可用和弃用。 稍后可以更改。
参数属性
| 类型: | System.String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UsePreDefinedValuesOnly
指示是否只能将预定义值分配给自定义安全属性。 如果设置为 false，则允许自由格式值。 以后可以从 true 更改为 false，但不能从 false 更改为 true。 如果类型设置为布尔值，则 usePreDefinedValuesOnly 无法设置为 true。
参数属性
| 类型: | System.Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。