Set-AzureADUserLicense
ユーザーに割り当てられたライセンスの一覧に、Microsoft オンライン サービスのライセンスを追加または削除します。
注
Set-AzureADUserLicense コマンドレットは非推奨です。 Microsoft Graph PowerShell を使用してライセンスを割り当てる方法について説明します。 詳細については、「 ライセンスの割り当て 」 Microsoft Graph API を参照してください。
構文
Default (既定)
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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。 このパラメーターに使用できる値は次のとおりです。
- 続ける
- 不問に付す
- 問い合わせる
- 静かに続行
- 止まれ
- [中断]
パラメーターのプロパティ
| 型: | ActionPreference |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | infa |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InformationVariable
情報変数を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | iv |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ObjectId
Azure AD のユーザーの ID (UPN または ObjectId) を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
メモ
Microsoft Graph PowerShell への Set-AzureADUserLicense の移行ガイド を参照してください。