Microsoft Graph PowerShell モジュールをインストールする方法
<本文>
このガイドでは、Microsoft Graph PowerShell モジュールをインストールする方法を説明します。 Graph PS モジュールは、Entra ID、Exchange Online、Outlook、SharePoint、Teams などの Microsoft 365 サービス全体でタスクを管理および自動化する方法を提供します。
Microsoft Graph PowerShell SDK は基本的に、Microsoft.Graph と Microsoft.Graph.Beta の 2 つのモジュールで提供されます。これらのモジュールは、それぞれ Microsoft Graph v1.0 および Microsoft Graph ベータ エンドポイントと対話し、同じバージョンの PowerShell に一緒にインストールできます。
PC にパッチを適用してサードパーティ アプリケーションをインストールおよび更新する
Microsoft Graph PowerShell SDK の主な機能と利点
Microsoft Graph PowerShell SDK を使用すると、組織に次の機能と利点が提供されます。
-
Microsoft 365 サービスへの統合アクセス: Microsoft Graph PowerShell モジュールは Microsoft Graph API に接続し、Microsoft Entra、Intune などの Microsoft 365 サービス全体のデータとリソースへのアクセスを提供します。
-
自動化: Graph SDK コマンドレットを使用すると、ユーザー管理、グループ作成、ライセンス割り当てなどの管理タスクを自動化できます。
-
外部 ID のサポート: 外部の Microsoft Entra テナントのユーザーは、Microsoft Graph PowerShell SDK を使用してテナント内のサービスに対する認証を行うことができます。
-
クロスプラットフォーム サポート: Microsoft Graph PowerShell は、Windows、macOS、Linux などのすべてのプラットフォームで動作します。
-
最小限の特権が必要です: Microsoft Graph PowerShell のアクセス許可は事前承認されていないため、ユーザーは特定のニーズに基づいてアプリのアクセス許可を求める 1 回限りの要求を送信する必要があります。
-
安全な認証: 対話型サインイン、証明書ベースの認証、マネージド ID (Azure リソース用) などの認証方法をサポートします。
-
定期的な更新の受信: Microsoft は、Graph API の最新の拡張機能と機能に合わせて、Graph PowerShell コマンドを頻繁に更新します。
Microsoft Graph PowerShell の機能と利点の完全なリストを確認してください。
前提条件
Windows PowerShell で Microsoft Graph PowerShell SDK を使用するには、次の前提条件が必要です。
- PowerShell 5.1 以降がインストールされていることを確認してください。すべてのプラットフォームで Microsoft Graph PowerShell SDK で使用する場合、PowerShell 7 以降が推奨される PowerShell バージョンです。
※.NET Framework 4.7.2以降がインストールされている必要があります。
-
Install-Module PowerShellGet コマンドレットを使用して、PowerShellGet を最新バージョンに更新する必要があります。
-
PowerShell スクリプト実行ポリシーは、リモート署名または制限の少ないものに設定する必要があります。
Microsoft Graph PowerShell モジュールをインストールする手順
次に、Microsoft Graph PowerShell モジュールをインストールする手順を説明します。これは、Microsoft の公式手順に従って、スムーズでエラーのないインストールを保証します。
ステップ 1: PS 実行ポリシーを RemoteSigned に設定する
Microsoft Graph PowerShell モジュールをインストールするには、PowerShell 実行ポリシーが RemoteSigned に設定されていることを確認してください。これを実現するには、管理者として PowerShell を開き、以下のコマンドを実行して、現在のデバイス上で PS 実行ポリシーを Restricted から RemoteSigned に変更します。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
コピー
Set-ExecutionPolicy
-
ExecutionPolicy RemoteSigned
-
Scope CurrentUser
PowerShell 実行ポリシーをリモート署名付きに設定してください
ステップ 2: Microsoft PowerShellGet モジュールをインストールする
管理者として PowerShell を開き、以下のコマンドを実行して最新バージョンの PowerShellGet をインストールします。
Install-Module PowerShellGet -Force -AllowClobber
コピー
Install-Module
PowerShellGet
-
Force
-
AllowClobber
次のコマンドを実行して、インストールされている PowerShellGet モジュールのバージョンを確認します。
Get-Module PowerShellGet -ListAvailable
コピー
Get-Module
PowerShellGet
-
ListAvailable
Microsoft PowerShellGet モジュールをインストールしてください
ステップ 3: Microsoft Graph PowerShell モジュールをインストールする
Install-Module コマンドレットは、MS Graph PowerShell モジュールの推奨されるインストール方法です。管理者として PowerShell を開き、以下のコマンドを実行して Microsoft Graph PowerShell モジュールをインストールします。
以下のコマンドを実行して、SDK の v1 モジュールを PowerShell Core または Windows PowerShell にインストールします。
Install-Module Microsoft.Graph -Scope CurrentUser -Repository PSGallery -Force
コピー
Install-Module
Microsoft.Graph
-
Scope CurrentUser
-
Repository PSGallery
-
Force
次のコマンドを実行して、すべてのユーザー スコープの Microsoft.Graph v1 モジュールをインストールします。
Install-Module Microsoft.Graph -Scope AllUsers -Repository PSGallery -Force
コピー
Install-Module
Microsoft.Graph
-
Scope AllUsers
-
Repository PSGallery
-
Force
Microsoft Graph PowerShell モジュールのインストール
ステップ 4: Graph PowerShell モジュールのインストールを確認する
インストールが完了したら、次のコマンドを使用して、インストールされている Graph PowerShell のバージョンを確認できます。
Get-InstalledModule Microsoft.Graph
コピー
Get-InstalledModule
Microsoft.Graph
以下の画像では、インストールされている Microsoft.Graph モジュールのバージョンが 2.31.0 であることがわかります。出力内のバージョンは、PowerShell ギャラリーで公開されている最新バージョンと一致する必要があります。
Graph PowerShell モジュールのインストールを確認してください
Microsoft Graph PowerShell に接続します
次に、Microsoft Graph との認証されたセッションを確立するために使用される Microsoft Graph PowerShell SDK 内の PowerShell コマンドレットである Connect-MgGraph の使用方法を説明します。
Microsoft Graph PowerShell は、委任されたアクセスとアプリのみのアクセスという 2 種類の認証をサポートしています。環境、アプリケーション ID、証明書など、認証に必要な必須パラメーターを管理するために、さまざまなコマンドレットが使用できます。
以下では、Graph PowerShell に簡単に接続する方法を示しましたが、他の接続方法の詳細な説明は別の投稿で説明します。
以下のコマンドを実行して、対話型認証を使用して Microsoft Graph に接続し、セッションに必要なアクセス許可 (スコープ) を指定します。
Connect-MgGraph -Scopes "User.Read.All", "Group.ReadWrite.All"
コピー
Connect-MgGraph
-
Scopes
"User.Read.All"
,
"Group.ReadWrite.All"
上記のコマンドを実行したら、資格情報を使用してサインインし、認証を完了する必要があります。
Microsoft Graph PowerShell に接続します
認証が成功すると、Microsoft Graph コマンド ライン ツールにより、組織を代表して同意を与えるように求められます。必要なアプリ権限を注意深く確認し、「同意する」をクリックします。
Microsoft Graph PowerShell に接続します
Microsoft.Graph PowerShell のベータ モジュールのインストール
これはオプションのステップです。 Microsoft.Graph PS のベータ モジュールをインストールするには、次のコマンドを実行します。
Install-Module Microsoft.Graph.Beta -Repository PSGallery -Force
コピー
Install-Module
Microsoft.Graph.Beta
-
Repository PSGallery
-
Force
次のコマンドを使用して、Microsoft Graph PowerShell SDK とそのすべての依存関係を更新できます。
Update-Module Microsoft.Graph
コピー
Update-Module
Microsoft.Graph
最新バージョンの Microsoft Graph PowerShell SDK を既に実行している場合、コマンドは実行されますが、更新が必要ないことを示す出力は返されません。
Microsoft Graph PowerShell SDK モジュールを更新する
Microsoft Graph の接続を解除する
Microsoft Graph でタスクを完了したら、Disconnect-MgGraph コマンドレットを使用して必ず切断してください。
以下の PowerShell コマンドを実行してサインアウトし、Microsoft Graph を完全に切断します。
Disconnect-MgGraph
コピー
Disconnect-MgGraph
Microsoft Graph PowerShell SDK をアンインストールする
インストールされているすべてのバージョンの Microsoft Graph PowerShell SDK を削除する場合は、PowerShell で次のコマンドを実行します。
Uninstall-Module Microsoft.Graph -AllVersions
コピー
Uninstall-Module
Microsoft.Graph
-
AllVersions
次に、Microsoft.Graph 依存関係モジュールをすべて削除するには、次のコマンドを実行します。
Get-InstalledModule Microsoft.Graph.* | ? Name -ne "Microsoft.Graph.Authentication" | Uninstall-Module -AllVersionsUninstall-Module Microsoft.Graph.Authentication -AllVersions
コピー
Get-InstalledModule
Microsoft.Graph.
*
|
?
Name
-ne
"Microsoft.Graph.Authentication"
|
Uninstall-Module
-
AllVersions
Uninstall-Module
Microsoft.Graph.Authentication
-
AllVersions
結論
このガイドにより、Microsoft Graph PowerShell モジュールのインストールが簡単になれば幸いです。 Microsoft Graph PowerShell モジュールは、Microsoft Graph API の API ラッパーであり、Microsoft 365 サービスを管理するための強力なツールです。管理タスクの自動化、ユーザーとグループの管理、レポートの取得のいずれを行う場合でも、このモジュールは、PowerShell を使用して Microsoft Graph API を操作する便利かつ効率的な方法を提供します。
ご質問がございましたら、以下のコメント欄にご記入ください。
まだサポートが必要ですか?
上記の記事についてさらにサポートが必要な場合、または他の技術的な問題について議論したい場合は、これらのオプションのいくつかを確認してください。
フォーラム
電報
連絡してください
*️⃣ 出典リンク:
Microsoft Graph PowerShell SDK、Exchange Online PowerShell モジュールをインストールする方法、、Microsoft Graph PowerShell の機能と利点](
https://learn.microsoft.com/en-us/powershell/microsoftgraph/overview?view=graph-powershell-1.0#microsoft-graph-powershell-features--benefits) 、
PowerShell 5.1 以降 、
.NET Framework 4.7.2 以降 、PowerShell スクリプト実行ポリシー、
Microsoft の公式手順 、
PowerShell ギャラリー 、
Connect-MgGraph 、
フォーラム
、 電報、
連絡してください
、