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 の移行ガイド を参照してください。