Get-EntraUserLicenseDetail

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

ユーザーのライセンスの詳細を取得します。

構文

Default (既定) 

Get-EntraUserLicenseDetail

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

説明

このコマンドレットは、ユーザーのライセンスの詳細を取得します。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーには、サポートされているMicrosoft Entra ロールまたはmicrosoft.directory/users/licenseDetails/readアクセス許可を持つカスタム ロールが必要です。 この操作は、次の最小特権ロールでサポートされています。

  • ゲスト招待者
  • ディレクトリの読み手
  • ディレクトリ製作者
  • ライセンス管理者
  • ユーザー管理者

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーには、サポートされているMicrosoft Entra ロールまたはmicrosoft.directory/users/licenseDetails/readアクセス許可を持つカスタム ロールが必要です。 この操作は、次の最小特権ロールでサポートされています。

  • ゲスト招待者
  • ディレクトリの読み手
  • ディレクトリ製作者
  • ライセンス管理者
  • ユーザー管理者

例

例 1: ユーザー ライセンスの詳細を取得する

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserLicenseDetail -UserId 'SawyerM@contoso.com'

Id                                          SkuId                                SkuPartNumber
--                                          -----                                -------------
X8Wu1RItQkSNL8zKldQ5DiH6ThjDmF1OlavQcFOpbmc aaaaaaaa-0b0b-1c1c-2d2d-333333333333 INFORMATION_PROTECTION_COMPLIANCE
X8Wu1RItQkSNL8zKldQ5Dk8SXrDMx6BFpqqM94yUaWg bbbbbbbb-1c1c-2d2d-3e3e-444444444444 EMSPREMIUM
X8Wu1RItQkSNL8zKldQ5DmAn38eBLPdOtXhbU5K1cd8 cccccccc-2d2d-3e3e-4f4f-555555555555 ENTERPRISEPREMIUM

この例では、Microsoft Entra IDからユーザーのライセンスの詳細を取得する方法を示します。

パラメーター

-Property

返されるプロパティを指定します。

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

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Select

パラメーター セット

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

-UserId

ライセンスの詳細を取得するユーザーのオブジェクト ID。 Microsoft Entra IDのユーザーの UserPrincipalName または UserId の ID を指定します。

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

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

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

CommonParameters

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

入力

System.String

出力

System.Object