Set-AzureADUserLicense

  • リファレンス
モジュール:
AzureAD

ユーザーに割り当てられたライセンスの一覧に、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

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

Type:AssignedLicenses
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

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

  • 続行
  • Ignore
  • 照会
  • SilentlyContinue
  • Stop
  • [中断]
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

情報変数を指定します。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

メモ

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