Get-EntraExtensionProperty

モジュール:
Microsoft.Entra.DirectoryManagement Module v1.3

Microsoft Entra IDに登録されている拡張機能のプロパティを取得します。

構文

Default (既定) 

Get-EntraExtensionProperty

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

説明

Get-EntraExtensionProperty コマンドレットは、Microsoft Entra ID Connect を介してMicrosoft Entra IDに登録された拡張プロパティを含むコレクションを取得します。

オンプレミスのMicrosoft Entra IDまたは両方の種類と同期されていないオンプレミスのMicrosoft Entra IDと同期される拡張機能のプロパティを取得できます。

このコマンドは、マルチテナント アプリの定義を含め、ディレクトリに登録されているすべてのディレクトリ拡張機能定義を返します。 次のエンティティは、拡張機能のプロパティをサポートしています。

  • User
  • グループ
  • アドミニストレーションユニット
  • 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

このコマンドレットが同期されている拡張機能プロパティを取得するかどうかを指定します。

  • $True- オンプレミスのMicrosoft Entra IDから同期される拡張機能プロパティを取得します。
  • $False- オンプレミスのMicrosoft Entra IDから同期されていない拡張機能プロパティを取得します。
  • No value - すべての拡張プロパティ (同期済みと非同期の両方) を取得します。

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

拡張機能名を使用してフィルター処理します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Default
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。