【Microsoft365参考書】複数のユーザーのライセンスを一括で変更するには？

ライセンス一括変更

<事前準備> Microsoft Graph APIに接続します
テナントに紐づくライセンス情報を確認する
- 説明
ライセンス内のサービスを確認する
- 説明
登録ユーザーのCSV ファイルを作成する
- 説明
ライセンスの割り当てと削除を同時に行う
- 説明

AzureAD / MSOnline コマンドレットは廃止されるため、Windows PowerShell を利用し、複数ユーザーのライセンスを一括で変更する方法 (ライセンスの削除と割り当てを同時に行う方法) のコマンドレットが変更されます。

Microsoft Graph APIに接続して実行する方法になりますので、以下に手順をご紹介したいと思います。

<事前準備> Microsoft Graph APIに接続します

以下の記事をもとにMicrosoft Graph PowerShell 用モジュールのインストールをお願いいたします。

it-bibouroku.hateblo.jp

Windows PowerShell右クリックして[管理者として実行] で起動します。

以下のコマンドレットを実行し、管理者ユーザーのID とパスワードを入力します。

【コマンドレット】

Connect-MgGraph -Scopes "Organization.Read.All","User.ReadWrite.All"

以下のコマンドレットを実行し、モジュールをインポートします。

【コマンドレット】

Import-Module -Name Microsoft.Graph.Users

テナントに紐づくライセンス情報を確認する

以下のコマンドレットを実行し、契約中のライセンスの SkuId を確認します。

【コマンドレット】

Get-MgSubscribedSku | ft Id, SkuId, SkuPartNumber -Wrap

【出力例】

Id SkuId SkuPartNumber

-- ----- --------

a818a9d9-4bf7-4316-b8bb-e0f1a52ce5ea_06ebc4ee-1bb5-47dd-8120-11324bc54e06 06ebc4ee-1bb5-47dd-8120-11324bc54e06 SPE_E5

a818a9d9-4bf7-4316-b8bb-e0f1a52ce5ea_05e9a617-0261-4cee-bb44-138d3ef5d965 05e9a617-0261-4cee-bb44-138d3ef5d965 SPE_E3

説明

・上記実行例では、[Microsoft 365 E5] と [Microsoft 365 E3] ライセンスの SkuId を確認してます。テナントにて複数のライセンスを所有している場合には所得しているすべてのサービスプランが表示されます。

・ Graph でのライセンス付与コマンドレットでは、ライセンスを SkuId にて指定します。各ライセンスの SkuId は下記の公開情報もご参照ください。

learn.microsoft.com

ライセンス内のサービスを確認する

以下のコマンドレットを実行し、ライセンスに含まれるサービスプランの一覧から無効にするサービスプラン名を確認します。

【コマンドレット】

Get-MgSubscribedSku -SubscribedSkuId "<Get-MgSubscribedSku コマンドで確認した、サービスプランを確認したいライセンスの Id>" | Select-Object -ExpandProperty ServicePlans | ft ServicePlanId, ServicePlanName

【実行例】

Get-MgSubscribedSku -SubscribedSkuId "a818a9d9-4bf7-4316-b8bb-e0f1a52ce5ea_05e9a617-0261-4cee-bb44-138d3ef5d965" | Select-Object -ExpandProperty ServicePlans | ft ServicePlanId, ServicePlanName

説明

・上記実行例では、[Microsoft 365 E3 (SPE_E3)] に含まれるサービスプランを確認しています。

・出力された値をもとに、後述するコマンドレットでサービスプランの付与内容を作成します。

登録ユーザーのCSV ファイルを作成する

特定のライセンスが割り当てられているユーザーの CSV ファイルを作成します。

【コマンドレット】

$skuId = "<ライセンスの skuId>"

$path = "< CSV ファイルの出力先のパス>"

$users = Get-MgUser -All -Filter "assignedLicenses/any(s:s/skuId eq $skuId)"

$users |select @{n="ObjectId"; e={$_.Id}}, @{n="UserPrincipalName"; e={$_.UserPrincipalName}}, @{n="DisplayName"; e={$_.DisplayName}} | Export-Csv -NoTypeInformation -Encoding UTF8 -Path $path

【実行例】

$skuId = "06ebc4ee-1bb5-47dd-8120-11324bc54e06"

$path = "C:\temp\assignedUser.csv"

$users = Get-MgUser -All -Filter "assignedLicenses/any(s:s/skuId eq $skuId)"

$users |select @{n="ObjectId"; e={$_.Id}}, @{n="UserPrincipalName"; e={$_.UserPrincipalName}}, @{n="DisplayName"; e={$_.DisplayName}} | Export-Csv -NoTypeInformation -Encoding UTF8 -Path $path

説明

・上記実行例では [Microsoft 365 E5 (06ebc4ee-1bb5-47dd-8120-11324bc54e06)] が付与されたユーザーを、C ドライブの temp フォルダに assignedUser.csv として出力します。

・出力された一覧から、ライセンス内容の変更を行うユーザーのみをファイルに残し保存します。

・ Excel で編集する場合は保存する際に [CSV UTF-8 (コンマ区切り)] 形式で保存してください。

・その他のライセンスを持つユーザーを出力する場合は、上記実行例の $skuId = "06ebc4ee-1bb5-47dd-8120-11324bc54e06" を 1. の手順で確認したライセンスの SkuId に置き換えます。

・エラー発生時のリスク回避のため、作成する 1 つの CSV ファイルでは、1000 ユーザー以内で作成し、以下にご案内する変更のコマンドレットを複数回に分けて実行いただくことをお勧めいたします。

ライセンスの割り当てと削除を同時に行う

以下のコマンドレットを実行し、ライセンスの割り当てと削除を同時に行います。

【コマンドレット】

$License1 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = "<割り当てるライセンスの SkuId>"; DisabledPlans = @("<無効にするサービスプランの ServicePlanId>")}

Import-Csv <csv ファイルのパス名> | ForEach-Object { Set-MgUserLicense -UserId $_.UserPrincipalName -AddLicenses @(<ライセンスオプション>) -RemoveLicenses @("削除するライセンスの SkuId") }

【実行例】

$License1 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = "05e9a617-0261-4cee-bb44-138d3ef5d965"; DisabledPlans = @("a23b959c-7ce8-4e57-9140-b90eb88a9e97","7547a3fe-08ee-4ccb-b430-5077c5041653")}

Import-Csv C:\temp\assignedUser.csv | ForEach-Object { Set-MgUserLicense -UserId $_.UserPrincipalName -AddLicenses @($License1) -RemoveLicenses @("06ebc4ee-1bb5-47dd-8120-11324bc54e06") }

説明

・上記実行例では、手順 3. で作成した CSV ファイルに記載されているユーザーに対して、[Microsoft 365 E3 (SPE_E3) (05e9a617-0261-4cee-bb44-138d3ef5d965)] 内の [Sway (SWAY) (a23b959c-7ce8-4e57-9140-b90eb88a9e97)] と [Yammer Enterprise (YAMMER_ENTERPRISE) (7547a3fe-08ee-4ccb-b430-5077c5041653)] が無効になっているライセンスを付与し、[Microsoft 365 E5 (SPE_E5) (06ebc4ee-1bb5-47dd-8120-11324bc54e06)] ライセンスを削除しています。