この記事では、Microsoft Entra PowerShell モジュールで委任されたアクセスを使用する方法について説明します。 委任されたアクセスを使用すると、アプリケーションは現在サインインしているユーザーに代わってアクションを実行できます。
このシナリオは、多要素認証 (MFA) を使用する場合など、手動サインインが必要な 1 回限りの管理タスクや環境に最適です。 また、ユーザーの操作を伴わないサービス プリンシパルやその他のアプリ専用認証方法を設定する必要なく、スクリプトのテスト、学習、タスクの管理も簡単になります。
認証の委任されたアクセス方法が推奨されるサインイン方法ですが、次のような他の対話型認証方法を使用することもできます。
- 承認コード フロー
- デバイス コード フロー
- アクセス トークン
この記事では、Microsoft Entra リソースを管理するために Microsoft Entra PowerShell にサインインするさまざまな方法について説明します。
前提条件
委任されたアクセス権を持つ Microsoft Entra PowerShell に接続するには、次のものが必要です。
- Microsoft Entra ID アカウント。 アカウントをまだお持ちでない場合は、 無料でアカウントを作成できます。
- 次のいずれかのロール:
- Microsoft Entra PowerShell モジュールがインストールされています。 インストール ガイドに従ってモジュールをインストールします。
カスタム アプリケーションで委任されたアクセスを使用する (推奨)
このセクションでは、カスタム アプリケーションで委任されたアクセスを使用してモジュールに接続する方法について説明します。 カスタム アプリケーションを特定のニーズに合わせて調整して、モジュールの使用に付与されるアクセス許可を分離して制限することができます。
次のコマンドを実行して、カスタム アプリケーションを使用して委任されたアクセス権を持つモジュールに接続します。 少なくとも クラウド アプリケーション管理者 ロールでサインインする必要があります。
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -ClientId <your-custom-app-id>
この例で-ClientIdと呼ばれるyour-custom-app-id値を取得するには、「カスタム アプリケーションの作成」ガイドの手順に従います。
その他のサインイン方法
このセクションでは、他のサインイン方法を使用して powerShell Microsoft Entra接続する方法について説明します。
承認コード フローを使用する
モジュールの既定のサインイン認証方法では、Web ブラウザーとアクセス トークンを使用してサインインします。 対話形式でサインインするには、既定で対話型のブラウザー ベースのサインイン プロンプトを使用する Connect-Entra コマンドレットを使用します。
Connect-Entra
既定のブラウザーを開き、Microsoft Entra のサインイン ページを読み込むための認証コード フローを開始します。
たとえば、ユーザーの詳細を取得するには、 -Scopes パラメーターを追加して、必要なアクセス許可の一覧を指定します。
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All'
デバイス コード フロー認証方法を使用する
デバイス コード フローは、microsoft.com/devicelogin でブラウザー ページを開き、PowerShell セッションに表示されるコードを入力するように指示します。
Connect-Entra -Scopes 'User.Read.All', 'Group.ReadWrite.All' -UseDeviceCode
アクセス トークンを使用する
次の例では、既にアクセス トークンがあることを前提としています。 トークン エンドポイントからアクセス トークンを取得する方法を参照してください。
$accessToken = '{my-securely-acquired-token}'
$secureString = ConvertTo-SecureString -String $accessToken -AsPlainText -Force
Connect-Entra -AccessToken $secureString
パスワードレス認証を使用する
パスワードレス認証は、パスワードを使用せずにユーザーの ID を確認する方法です。 パスワードは主要な攻撃ベクトルであり、パスワードレス認証は、不適切なアクターがソーシャル エンジニアリング、フィッシング、スプレー攻撃を使用してパスワードを侵害する攻撃を軽減するための戦略です。
Microsoft Entra PowerShell では、次のパスワードレス認証方法がサポートされています。
- Windows Hello for Business
- Fast ID Online v2.0 (FIDO2)
- Microsoft Authenticator アプリ
- 証明書ベースの認証 (CBA)
Note
FIDO2 セキュリティ キー オプションは、PowerShell 7 以降でのみサポートされています。
詳細については、「Microsoft Entra IDのパスワードレス認証オプション」を参照してください。
一般的なエラーとトラブルシューティングのヒント
一般的な認証エラーは次のとおりです。
- "操作を完了するための特権が不足しています" - 資格情報が正しくないか、Microsoft Entra リソースにアクセスするために必要なアクセス許可がない場合にエラーが発生します。
- ""コマンドレット名" という用語はコマンドレットの名前として認識されません。 - エラーは、Microsoft Entra PowerShell モジュールがインストールまたは読み込まれていないことを示します。 使用するコマンドレットに適したモジュールをインストールして読み込みます。
一般的なエラーのトラブルシューティングの詳細なガイドについては、 トラブルシューティング ガイドを参照してください。