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。