Set-EntraBetaCustomSecurityAttributeDefinition
更新 customSecurityAttributeDefinition 物件的屬性。
語法
Default (預設值)
Set-EntraBetaCustomSecurityAttributeDefinition
-Id <String>
[-Description <String>]
[-Status <String>]
[-UsePreDefinedValuesOnly <Boolean>]
[<CommonParameters>]
Description
更新 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
指出是否只能將預先定義的值指派給自訂安全性屬性。 若設為假，則允許自由形式值。 之後可以從真改為假，但不能從假改為真。 如果類型設為布林值，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。