Get-EntraExtensionProperty

取得以 Microsoft Entra ID 註冊的擴充功能屬性。

語法

Default (預設值)

Get-EntraExtensionProperty

    [-IsSyncedFromOnPremises <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Get-EntraExtensionProperty cmdlet 會得到一個集合,包含透過 Microsoft Entra ID Connect 註冊的擴充屬性Microsoft Entra ID。

你可以取得與本地 Microsoft Entra ID 同步的擴充屬性,但這些屬性卻與本地的 Microsoft Entra ID 或兩者都不同步。

此指令會回傳目錄中所有註冊的目錄擴充定義,包括多租戶應用程式的定義。 以下實體支援擴充屬性:

  • 使用者
  • Group
  • 管理單位
  • Application
  • 裝置
  • Organization

範例

範例 1:從本地 Microsoft Entra ID 取得擴充功能屬性同步

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraExtensionProperty -IsSyncedFromOnPremises $True
Id                                   AppDisplayName DataType IsMultiValued IsSyncedFromOnPremises Name                                                         TargetObjects
--                                   -------------- -------- ------------- ---------------------- ----                                                         -------------
bd647a28-ae50-4e03-a915-067da7ff6cec Contoso App          String   False         False                  extension_12345_JobGroup          {User}
daa3b0e4-b14c-40a4-bb91-a2c017ac2b28 Contoso App          String   False         False                  extension_12345_CostCenter            {User}
4113c724-f8c3-4fdf-ac5b-b1cf1440ff55 Contoso App          String   False         False                  extension_12345_EmploymentNumber             {}

此指令會取得與本地 Microsoft Entra ID 同步的擴充屬性。

範例 2:利用擴充名稱取得擴充屬性

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraExtensionProperty -IsSyncedFromOnPremises $False -Name extension_12345_JobGroup
Id                                   AppDisplayName DataType IsMultiValued IsSyncedFromOnPremises Name                                                         TargetObjects
--                                   -------------- -------- ------------- ---------------------- ----                                                         -------------
bd647a28-ae50-4e03-a915-067da7ff6cec Contoso App     String   False         False                  extension_12345_JobGroup          {User}

此指令根據擴充名稱取得擴充功能(用戶端過濾)。

參數

-IsSyncedFromOnPremises

指定此 cmdlet 是否擁有同步或未同步的擴充屬性。

  • $True- 取得與本地 Microsoft Entra ID 同步的擴充功能屬性。
  • $False- 取得未同步於本地 Microsoft Entra ID 的擴充功能屬性。
  • No value - 取得所有擴充功能屬性(同步與非同步)。

參數屬性

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

參數集

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

-Name

用擴充功能名稱來篩選。

參數屬性

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

參數集

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

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。