次の方法で共有


Set-AzureADUserLicense

ユーザーに割り当てられたライセンスの一覧に Microsoft オンライン サービスのライセンスを追加または削除します。

注意

Set-AzureADUserLicense コマンドレットは非推奨です。 Microsoft Graph PowerShell でライセンスを割り当てる方法について説明します。 詳細については、「 ライセンスの割り当て Microsoft Graph API」を参照してください。

構文

Set-AzureADUserLicense
   -ObjectId <String>
   -AssignedLicenses <AssignedLicenses>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

説明

Set-AzureADUserLicense は、ユーザーに割り当てられたライセンスの一覧に Microsoft オンライン サービスのライセンスを追加または削除します。

例 1: テンプレート ユーザーに基づいてユーザーにライセンスを追加する

PS C:\> $LicensedUser = Get-AzureADUser -ObjectId "TemplateUser@contoso.com"  
PS C:\> $User = Get-AzureADUser -ObjectId "User@contoso.com"  
PS C:\> $License = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicense 
PS C:\> $License.SkuId = $LicensedUser.AssignedLicenses.SkuId 
PS C:\> $Licenses = New-Object -TypeName Microsoft.Open.AzureAD.Model.AssignedLicenses 
PS C:\> $Licenses.AddLicenses = $License 
PS C:\> Set-AzureADUserLicense -ObjectId $User.ObjectId -AssignedLicenses $Licenses

最初のコマンドは、Get-AzureADUser (./Get-AzureADUser.md) コマンドレットを使用してユーザーを取得し、それを $LicensedUser 変数に格納します。

2 番目のコマンドでは、 Get-AzureADUser を使用して別のユーザーを取得し、それを $User 変数に格納します。

3 番目のコマンドは AssignedLicense 型を作成し、それを $License 変数に格納します。

4 番目のコマンドは、$License の SkuId プロパティを $LicensedUser の SkuId プロパティと同じ値に設定します。

5 番目のコマンドは AssignedLicenses オブジェクトを作成し、それを $Licenses 変数に格納します。

6 番目のコマンドは、$Licenseのライセンスを$Licensesに追加します。

最後のコマンドは、$Licensesのライセンスを$Userのユーザーに割り当てます。 $Licensesのライセンスには、3 番目と 4 番目のコマンドの$Licenseが含まれています。

パラメーター

-AssignedLicenses

割り当てまたは削除するライセンスの一覧を指定します。

型:AssignedLicenses
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InformationAction

このコマンドレットが情報イベントに応答する方法を指定します。 このパラメーターの有効値は、次のとおりです。

  • 続行
  • Ignore
  • 照会
  • SilentlyContinue
  • Stop
  • [中断]
型:ActionPreference
Aliases:infa
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InformationVariable

情報変数を指定します。

型:String
Aliases:iv
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ObjectId

Azure AD のユーザーの ID (UPN または ObjectId として) を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

メモ

Microsoft Graph PowerShell への Set-AzureADUserLicense の移行ガイド を参照してください。