PowerShell for Microsoft 365 を使用して、ユーザー アカウントを削除および復元できます。
Microsoft Graph PowerShell を使用してユーザー アカウントを削除する
注:
Azure Active Directory (AzureAD) PowerShell モジュールは非推奨となり、Microsoft Graph PowerShell SDK に置き換えられます。 Microsoft Graph PowerShell SDK を使用して、すべての Microsoft Graph API にアクセスできます。 詳細については、「Microsoft Graph PowerShell SDK の使用を開始する」 を参照してください。
Microsoft Graph PowerShell のインストールと Microsoft Graph PowerShell へのアップグレードの方法については、「Microsoft Graph PowerShell SDK のインストール」と「 Azure AD PowerShell から Microsoft Graph PowerShell へのアップグレード」も参照してください。
無人スクリプトでさまざまな方法を使用して Connect-Graph を認証する方法については、「 Microsoft Graph PowerShell の認証モジュール コマンドレット」の記事を参照してください。
ユーザー アカウントを削除するには、User.ReadWrite.All アクセス許可スコープが必要です。このスコープは、"ライセンスの割り当て" Microsoft Graph API リファレンス ページに記載されています。
テナント内のユーザー アカウントの詳細を読み取るために、User.Read.All アクセス許可スコープが必要です。
# Connect to your tenant
Connect-MgGraph -Scopes User.Read.All, User.ReadWrite.All
接続した後、次の構文を使用して個々のユーザー アカウントを削除します。
$userName="<display name>"
# Get the user
$userId = (Get-MgUser -Filter "displayName eq '$userName'").Id
# Remove the user
Remove-MgUser -UserId $userId -Confirm:$false
この例では、ユーザー アカウント Caleb Sills を削除します。
$userName="Caleb Sills"
$userId = (Get-MgUser -Filter "displayName eq '$userName'").Id
Remove-MgUser -UserId $userId -Confirm:$false
ユーザー アカウントを復元する
Microsoft Graph PowerShell を使用してユーザー アカウントを復元するには、まず Microsoft 365 テナントに接続します。
削除されたユーザー アカウントを復元するには、アクセス許可スコープ Directory.ReadWrite.All が必要です。 このアクセス許可スコープを使用してテナントに接続します。
# Connect to your tenant
Connect-MgGraph -Scopes Directory.ReadWrite.All
削除されたユーザー アカウントはディレクトリ内のオブジェクト以外に存在しなくなったため、復元するユーザー アカウントを検索することはできません。 代わりに、次の PowerShell スクリプトを使用して、 ディレクトリで microsoft.graph.user 型の削除されたオブジェクトを検索します。
$DeletedUsers = Get-MgDirectoryDeletedItem -DirectoryObjectId microsoft.graph.user -Property '*'
$DeletedUsers = $DeletedUsers.AdditionalProperties['value']
foreach ($deletedUser in $DeletedUsers)
{
$deletedUser | Format-Table
}
このスクリプトの出力は、削除されたユーザー オブジェクトがディレクトリに存在すると仮定すると、次のようになります。
Key Value
--- -----
businessPhones {}
displayName Caleb Sills
givenName Caleb
mail CalebS@litware.com
surname Sills
userPrincipalName cdea706c3fdc4bbd95925d92d9f71eb8CalebS@litware.com
id cdea706c-3fdc-4bbd-9592-5d92d9f71eb8
個々のユーザー アカウントを復元するには、次の構文を使用します。
# Input user account ID
$userId = "<id>"
# Restore the user
Restore-MgDirectoryDeletedItem -DirectoryObjectId $userId
次の使用例は、上記のスクリプトの出力から $userID の値を使用して、ユーザー アカウントcalebs@litwareinc.comを復元します。
$userId = "cdea706c-3fdc-4bbd-9592-5d92d9f71eb8"
Restore-MgDirectoryDeletedItem -DirectoryObjectId $userId
このコマンドの出力は次のようになります。
Id DeletedDateTime
-- ---------------
cdea706c-3fdc-4bbd-9592-5d92d9f71eb8
関連項目
Microsoft 365 ユーザー アカウント、ライセンス、PowerShell を使用したグループを管理する