GIGA スクール年度更新 | Microsoft 365 (2023 年度版) 第 1 版

By 中田寿穂, 文教営業統括本部 Azure スペシャリスト

2023年3月13日

変更点

MS OnlineMS Online PowerShell は 2023 年 3 月 31 日に MS Online PowerShell を使ったライセンス割り当ての機能の提供が終了し、さらに 2023 年 6 月 30 日に MS Online PowerShell が廃止されます。そのため、今後 PowerShell を使用してアカウントメンテナンスを行う場合は Microsoft Graph PowerShell を使用する必要があります。本記事ではMicrosoft Graph PowerShell を使用してアカウント管理について説明します。
MS Online PowerShell から Microsoft Graph PowerShell への移行についての詳細は、「Azure AD PowerShell から Microsoft Graph PowerShell への移行に関する FAQ」をご参照ください。

Microsoft Graph PowerShell SDK をインストールする

まずはじめに Microsoft Graph PowerShell を使用するために　Microsoft Graph PowerShell をインストールします。
Microsoft Graph PowerShell をインストールために PowerShell を管理者として起動します。

PowerShell が起動したら、以下のコマンドレットを実行して Microsoft Graph PowerShell SDK をインストールします。

> Install-Module Microsoft.Graph

初期設定ですと PSGallery が信頼されていないリポジトリとして設定されており、以下のような警告が表示されます。

> Install-Module Microsoft.Graph
信頼されていないリポジトリ
信頼されていないリポジトリからモジュールをインストールしようとしています。このリポジトリを信頼する場合は、Set-PSRepository コマンドレットを実行して、リポジトリの InstallationPolicyの値を変更してください。’https://www.powershellgallery.com/api/v2/’ からモジュールをインストールしますか?
[Y] はい(Y) [A] すべて続行(A) [N] いいえ(N) [L] すべて無視(L) [S] 中断(S) [?] ヘルプ (既定値は “N”):

[Y] を入力すれば Microsoft Graph PowerShell SDK はインストールされますが「PSGallery はある程度信頼できるだろう」と判断した場合にはこの警告を表示しないようにすることもできます。 Set-PSRepository を利用して PSGallery を信頼できるリポジトリとして設定することによって PSGallery にある様々なモジュールを警告無しにインストールできるようになります。
PSGallery の信頼するリポジトリーに変更する方法は以下の通りです。

# 設定値の確認
> Get-PSRepository
Name                      InstallationPolicy   SourceLocation
—-                      ——————   ————–
PSGallery                 Untrusted            https://www.powershellgallery.com/api/v2/
# PSGallery を信頼できるリポジトリに変更
> Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
# 設定値の確認
> Get-PSRepository
Name                     InstallationPolicy   SourceLocation
—                      ——————   ————–
PSGallery                 Trusted              https://www.powershellgallery.com/api/v2/

PowerShell を実行できるようにする

クライアント版 Windows の PowerShell は、標準設定ではスクリプト (拡張子 .ps1 のファイル) の実行が制限されています。これは、マルウェアなどの危険なスクリプトの不用意な実行を防ぐというセキュリティ上の配慮によるものです。自分で作成したスクリプトを実行するには事前に実行ポリシーを変更する必要があります。

実行ポリシーは、Set-ExecutionPolicy コマンドレット (または PowerShell コマンドの -ExecutionPolicy パラメータ) を用いて変更します。下記のコマンドを実行することで以下の PowerShell を実行することができるようになります。

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Microsoft 365 のライセンスを確認する

MS Online PowerShell では、Get-MsolAccountSku コマンドレットを使用することで、そのテナントで使用可能なライセンスを調べることができました。Microsoft Graph PoweShell では Get-MgSubscribedSku コマンドレットを使用して　SkuId　を取得します。
まずはじめに Get-MgSubscribedSku コマンドレットを使って Microsoft 365 に接続します。

Connect-MgGraph -Scopes “Organization.Read.All”,”User.ReadWrite.All”

ユーザー認証の画面が表示されますので、ID とパスワード (多様性認証を ON にしている場合には多要素認証) を入力します。
サインインができたら以下のコマンドレッドでモジュールを読み込みます。

Import-Module -Name Microsoft.Graph.Users

モジュールの読み込みが完了したら Get-MgSubscribedSku コマンドレッドを実行してこのテナントで利用できるライセンスの SkuId を取得します。

Get-MgSubscribedSku | ft SkuId, SkuPartNumber -Wrap

このように SkuId と SkuPartNumber が表示されます。

ユーザーにライセンスを割り当てる際には SkuId が必要になりますので、メモしておいてください。上記の例ですと SubParNumber に表示された STANDARDWOFFPACK_STUDENT が児童生徒用の Office 365 A1 ライセンス、STANDARDWOFFPACK_FACULTY が教職員用の Office 365 A1 ライセンス、M365_EDU_GIGA_PROMO が GIGA PROMO 用のライセンスになります。

アカウントの登録

アカウント登録用の CSV ファイルの作成

アカウント登録用の CSV ファイルのサンプルファイルをダウンロードしてください。
2 行目以降に必要なデータを入力します。アカウント登録する際に最低限必要な属性値は、UserPrincipalName, DisplayName, Password です。ユーザーに割り当てるライセンスは O 列から Q 列に記入してください。このドキュメントで提示するサンプルコードでは最大 3 種類のライセンスまで割り当てできるようになっています。

アカウント登録用の PowerShell スクリプトの作成

以下にアカウント登録用の PowerShell を示します。メモ帳などにコピーして、addm365user.ps1 といったファイル名で保存してください。
このスクリプトでは、パスワードの有効期限を無期限にする (-PasswordPolicies “DisablePasswordExpiration,DisableStrongPassword”)、初回ログイン時にパスワードの変更を要求しない (“forceChangePasswordNextSignIn” = $false)　ように設定しています。

###############################################################################################################################
# Name
#     addm365user.ps1 – Microsoft 365 にアカウントを追加する
# SYNOPSIS
#     addm365user [INPORT FILE]
# DESCRIPTION
#     Microsoft 365 のアカウント作成用の[INPORT FILE]を読み込み、Microsoft 365 にアカウントを登録、
#     ライセンス付与をし、AddedNewUsers-YYYY_MM_DD-HH_MM.csv に登録結果を出力します。
#     このスクリプトでは弱いパスワードも登録可能で、有効期限もなしになっています。また初期サイン時にパスワード変更も求められません。
#     CSVの書式は1行目にタイトル、2行目以降に登録データを入力します。
#     1行目: UserPrincipalName,Password,MailNickname,DisplayName,GivenName,SurName,JobTitle,EmployeeId,EmployeeType,Department,City,State,Country,StreetAddress,PostalCode,SkuId1,SkuId2,SkuId3
#     SkuId1～3 には、Get-MgSubscribedSku | ft SkuId, SkuPartNumber -Wrap　で取得した SkuId を入力してください。###############################################################################################################################
Connect-MgGraph -Scopes “User.ReadWrite.All” > $null
Import-Module -Name Microsoft.Graph.Users

date
echo ” Create new users”

$addedtime = Get-Date -format “yyyy_MM_dd-HH_mm”
$outputfilename = “AddedNewUsers-” + $addedtime + “.csv”

Import-Csv -Path $Args[0] -Encoding UTF8 | `
foreach {
   $UserPrincipalName = $_.UserPrincipalName
   $DisplayName = $_.DisplayName
   $MailNickName = $UserPrincipalName.Split(“@”)[0]
   $SurName = $_.SurName
   $GivenName = $_.GivenName
   $JobTitle = $_.JobTitle ; if([string]::IsNullOrEmpty($JobTitle)){$JobTitle = ” “}
   $EmployeeId = $_.EmployeeId ; if([string]::IsNullOrEmpty($EmployeeId)){$EmployeeId = ” “}
   $EmployeeType = $_.EmployeeType ; if([string]::IsNullOrEmpty($EmployeeType)){$EmployeeType = ” “}
   $Department = $_.Department ; if([string]::IsNullOrEmpty($Department)){$Department = ” “}
   $City = $_.City ; if([string]::IsNullOrEmpty($City)){$City = ” “}
   $State = $_.State ; if([string]::IsNullOrEmpty($State)){$State = ” “}
   $Country = $_.Country ; if([string]::IsNullOrEmpty($Country)){$Country = ” “}
   $PostalCode = $_.$PostalCode ; if([string]::IsNullOrEmpty($PostalCode)){$PostalCode = ” “}
   $StreetAddress = $_.$StreetAddress ; if([string]::IsNullOrEmpty($StreetAddress)){$StreetAddress = ” “}

If([string]::IsNullOrEmpty($GivenName) -or [string]::IsNullOrEmpty($SurName)) {
        New-MgUser -AccountEnabled -UserPrincipalName “$UserPrincipalName” -DisplayName “$DisplayName” -MailNickName “$MailNickname” -UsageLocation “JP” -JobTitle “$JobTitle” -EmployeeId “$EmployeeId” -EmployeeType “$EmployeeType” -Department “$Department” -City “$City” -State “$State” -Country “$Country” -PostalCode “$PostalCode” -StreetAddress “$StreetAddress” -PasswordPolicies “DisablePasswordExpiration,DisableStrongPassword” -PasswordProfile @{ “Password”=$_.Password ; “forceChangePasswordNextSignIn” = $false}
    }
    Else {
      New-MgUser -AccountEnabled -UserPrincipalName “$UserPrincipalName” -DisplayName “$DisplayName” -MailNickName “$MailNickname” -SurName “$SurName” -GivenName “$GivenName” -UsageLocation “JP” -JobTitle “$JobTitle” -EmployeeId “$EmployeeId” -EmployeeType “$EmployeeType” -Department “$Department” -City “$City” -State “$State” -Country “$Country” -PostalCode “$PostalCode” -StreetAddress “$StreetAddress” -PasswordPolicies “DisablePasswordExpiration,DisableStrongPassword” -PasswordProfile @{ “Password”=$_.Password ; “forceChangePasswordNextSignIn” = $false}
    }
} | Select-Object Id, UserPrincipalName, DisplayName, GivenName, Surname, JobTitle, EmployeeId, EmployeeType, Department, City, State, Country, StreetAddress, PostalCode | Export-Csv -Path $outputfilename -Encoding UTF8

date
echo ” Licensing to users”
Import-Csv -Path $Args[0] -Encoding UTF8 | `
foreach {
   $SkuId1 = $_.SkuId1
   $License1 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = $SkuId1}
   $SkuId2 = $_.SkuId2
   $License2 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = $SkuId2}
   $SkuId3 = $_.SkuId3
   $License3 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = $SkuId3}
    if([string]::IsNullOrEmpty($SkuId2)){
        $License1 = New-Object -TypeName Microsoft.Graph.PowerShell.Models.MicrosoftGraphAssignedLicense -Property @{SkuId = $SkuId1}
        Set-MgUserLicense -UserId $_.UserPrincipalName -AddLicenses @($License1) -RemoveLicenses @() > $null
        }
        elseif([string]::IsNullOrEmpty($SkuId3)){
            Set-MgUserLicense -UserId $_.UserPrincipalName -AddLicenses @($License1, $License2) -RemoveLicenses @() > $null
        }
        else {
            Set-MgUserLicense -UserId $_.UserPrincipalName -AddLicenses @($License1, $License2, $License3) -RemoveLicenses @() > $null
        }
}
Disconnect-MgGraph > $null
date
echo ” Completed”

アカウントの登録

addm365user.ps1 を実行して新規アカウントを登録します。入力ファイルには「アカウント登録用の CSV ファイル」で作成したファイルを使用してください。

addm365user.ps1 <入力ファイル名>

addm365user.ps1 を実行しますと、カレントディレクトリに AddedNewUsers-YYYY_MM_DD-HH_MM.csv ファイルが作成され、新しく登録されたユーザーの情報が保存されます。

すでに登録済みのユーザーを取得する

すでに登録されているユーザーリストの一覧を取得するスクリプト (getm365user.ps1) を以下に示します。
このスクリプトを実行するとカレントディレクトリに RegisteredUsers-YYYY_MM_DD-HH_MM.csv ファイルが作成され、すでに登録されているユーザー情報が保存されます。

###############################################################################################################################
# Name
# get365user.ps1 – Microsoft 365 に登録されているアカウントを取得する
# SYNOPSIS
# getm3365user
# DESCRIPTION
# Microsoft 365 に登録されているユーザーを取得して、RegisteredUsers_YYYY_MM_DD-HH_MM.csv に出力します。
###############################################################################################################################

Connect-MgGraph -Scopes “User.ReadWrite.All” > $null
Import-Module -Name Microsoft.Graph.Users

date
echo ” Get All users”
$addedtime = Get-Date -format “yyyy_MM_dd-HH_mm”
$outputfilename = “RegisteredUsers-” + $addedtime + “.csv”

Get-MgUser -All | Select-Object Id, UserPrincipalName, DisplayName, GivenName, Surname, JobTitle, EmployeeId, EmployeeType, Department, City, State, Country, StreetAddress, PostalCode | Export-Csv -Path $outputfilename -Encoding UTF8
date
echo ” Completed”

ユーザーを削除する

ユーザー削除リストの作成

削除したいユーザーリストを作成します。1 行目に UserPrincipalName と入力し、2 行目以降に削除したい UserPrincipalName を入力します。

ユーザー削除用の PowerShell

###############################################################################################################################
# Name
# rmm365user.ps1 – Microsoft 365 のアカウント削除する
# SYNOPSIS
#     rmm3365user [INPORT FILE]
# DESCRIPTION
#     [INPORT FILE] を読み込み、Microsoft 365 のアカウントを削除します。
#     削除したアカウントはゴミ箱に入り、30日後に自動的に完全削除されます。
#     30日以内にゴミ箱にいるユーザーを削除する場合には、rmm365deletedusers.ps1 コマンドを利用します。
#     削除用の [INPORT FILE]　は、
#     一行目: UserPrincilaName 2行目以降に削除するユーザー情報（UserPrincipalName）を入力してください。
###############################################################################################################################

Connect-MgGraph -Scopes “User.ReadWrite.All”
Import-Module -Name Microsoft.Graph.Users

date
echo ” Remove users”

Import-Csv -Path $Args[0] | foreach {Remove-MgUser -UserId $_.UserPrincipalName -PassThru}

Disconnect-MgGraph > $null

date
echo ” Completed”

ユーザーの削除

ユーザーを削除するには以下のコマンドレッドを実行します。

rmm365user <入力ファイル名>

削除されたユーザーはゴミ箱に入り、30 日後に自動削除されます。

ゴミ箱にいるユーザーを完全削除する

ゴミ箱にいるユーザー削除リストの作成

Microsoft 365 管理センターから削除済みのユーザーリストを取得します。

出力されたファイルを開き「オブジェクトId」→「ObjectId」に書き換えて保存します。

ゴミ箱のユーザー削除用の PowerShell

###############################################################################################################################
# Name
# rmm365deleteduser.ps1 – Microsoft 365 のアカウント削除する
# SYNOPSIS
#     rmm3365deleteduser [INPORT FILE]
# DESCRIPTION
#     [INPORT FILE] を読み込み、ゴミ箱にいるMicrosoft 365 のアカウントを削除します。、
#     一行目: Id 2行目以降に削除するユーザー情報(OObject Id）を入力してください。
###############################################################################################################################

Connect-MgGraph -Scopes “User.ReadWrite.All” > $null
Import-Module -Name Microsoft.Graph.Users

date
echo ” Remove deleted users”

Import-Csv -Path $Args[0] -Encoding UTF8 | foreach {Remove-MgDirectoryDeletedItem -DirectoryObjectId $_.Id}

Disconnect-MgGraph > $null

date
echo ” Completed”

ゴミ箱にいるユーザーの削除

ゴミ箱にいるユーザーには以下のコマンドを実行します。

rmm365deleteduser <入力ファイル>

中田寿穂

文教営業統括本部 Azure スペシャリスト

See more articles from this author

GIGA スクール年度更新 | Microsoft 365 (2023 年度版) 第 1 版

変更点

Microsoft Graph PowerShell SDK をインストールする

PowerShell を実行できるようにする

Microsoft 365 のライセンスを確認する

アカウントの登録

すでに登録済みのユーザーを取得する

ユーザーを削除する

ゴミ箱にいるユーザーを完全削除する

ゴミ箱にいるユーザー削除リストの作成

ゴミ箱のユーザー削除用の PowerShell

ゴミ箱にいるユーザーの削除

Related posts

Explore Microsoft industry solutions

変更点

Microsoft Graph PowerShell SDK をインストールする

PowerShell を実行できるようにする

Microsoft 365 のライセンスを確認する

アカウントの登録

すでに登録済みのユーザーを取得する

ユーザーを削除する

ゴミ箱にいるユーザーを完全削除する

ゴミ箱にいるユーザー削除リストの作成

ゴミ箱のユーザー削除用の PowerShell

ゴミ箱にいるユーザーの削除

Related posts

パブリックセクター向け会報「かけはし」2024年5月号発行

その熱狂が、世界を変える。Microsoft AI Tour 産業別セッションレポート【政府・公共機関】〜愛される行政を目指して、生成 AI の活用方法を模索する Government 業界〜

PoC を通して自分ごととしての DX を組織に根付かせる。JICA のデジタル意識変革

日本マイクロソフトは、「ガバメントクラウド早期移行団体検証事業」への応募を検討する自治体皆さまに対し、各種支援を提供