Get-EntraBetaCustomSecurityAttributeDefinition

會獲得一份自訂安全屬性定義清單。

語法

GetQuery (預設值)

Get-EntraBetaCustomSecurityAttributeDefinition

    [-Property <String[]>]
    [<CommonParameters>]

GetById

Get-EntraBetaCustomSecurityAttributeDefinition

    -Id <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

取得一份 Microsoft Entra ID 自訂安全屬性定義清單。 指定 Id 參數以取得自訂安全屬性定義清單。

在工作或學校帳號的委派情境中,登入使用者必須被指派一個支援的 Microsoft Entra 角色或具備必要權限的自訂角色。 此操作支援以下特權角色:

  • 屬性指定閱讀器
  • 屬性定義解讀器
  • 屬性指派系統管理員
  • 屬性定義管理員

範例

範例 1:取得所有自訂安全屬性定義的清單

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
Get-EntraBetaCustomSecurityAttributeDefinition
Id                                      AttributeSet          Description                         IsCollection IsSearchable Name                             Status     Type    UsePreDefinedValuesOnly
--                                      ------------          -----------                         ------------ ------------ ----                             ------     ----    -----------------------
Engineering_newvalue                    Engineering           New Eng Value          True         True         NewValue                         Available  String  False
Engineering_ProjectDate                 Engineering           Target completion date              False        True         ProjectDate                      Available  String  False

此範例回傳所有自訂的安全屬性定義。

範例 2:取得特定的自訂安全屬性定義

Connect-Entra -Scopes 'CustomSecAttributeDefinition.Read.All', 'CustomSecAttributeDefinition.ReadWrite.All'
$attributeDefinition = Get-EntraBetaCustomSecurityAttributeDefinition | Where-Object {$_.Name -eq 'Engineering'}
Get-EntraBetaCustomSecurityAttributeDefinition -Id $attributeDefinition.Id
Id                      AttributeSet Description            IsCollection IsSearchable Name        Status    Type   UsePreDefinedValuesOnly
--                      ------------ -----------            ------------ ------------ ----        ------    ----   -----------------------
Engineering_ProjectDate Engineering  Target completion date False        True         ProjectDate Available String False

此範例回傳一個特定的自訂安全屬性定義。

  • Id 參數指定自訂安全屬性定義物件 ID。

參數

-Id

Microsoft Entra ID 自訂安全屬性定義物件的唯一識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

GetById
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Property

指定要回傳的屬性

參數屬性

類型:

System.String[]

預設值: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。

輸入

System.String

輸出

System.Object