PowerShell セッション間でユーザーの資格情報を保持する

[アーティクル]
04/02/2024

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断とリスクに委ねられます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

Azure PowerShell では、Azure Context Autosave と呼ばれる機能を提供しています。その機能は以下のとおりです。

新しい PowerShell セッションで再利用するためにサインイン情報を保持する。
実行時間の長いコマンドレットを実行する場合にバックグラウンドタスクを使いやすくする。
個別のサインインを使用せずにアカウント、サブスクリプション、環境を切り替える。
同一の PowerShell セッションから、異なる資格情報やサブスクリプションを同時に使用してタスクを実行する。

Azure コンテキストの定義

"Azure コンテキスト" とは、Azure PowerShell コマンドレットの対象を定義する一連の情報です。このコンテキストは、次の 5 つの要素で構成されます。

"アカウント" - Azure との通信の認証に使用されるユーザー名またはサービスプリンシパル。
"サブスクリプション" - 処理対象のリソースを含む Azure サブスクリプション。
テナント - サブスクリプションを含む Microsoft Entra テナント。テナントは、サービスプリンシパル認証にとってより重要になります。
"環境" - 対象となる特定の Azure クラウド (通常は Azure グローバルクラウド)。ただし、環境設定では、国内、政府、オンプレミス (Azure Stack) クラウドも対象にすることができます。
"資格情報" - 本人確認と Azure のリソースへのアクセスの承認のために Azure で使用される情報

以前のリリースでは、新しい PowerShell セッションを開くたびに Azure コンテキストを作成する必要がありました。 Azure PowerShell v4.4.0 以降では、新しい PowerShell セッションを開くたびに Azure コンテキストを自動的に保存できます。

バージョン 6.3.0 以降、Azure PowerShell では、セッション間で自動的にコンテキスト情報が保持されます。コンテキストと資格情報を記憶しないように PowerShell を設定するには、Disable-AzureRmContextAutoSave を使用します。 PowerShell セッションを開くたびに Azure へのサインインが必要になります。

PowerShell セッションが終了した後に Azure PowerShell がコンテキストを記憶できるようにするには、Enable-AzureRmContextAutosave を使用します。コンテキストと資格情報は、ユーザーディレクトリの特殊な隠しフォルダー (%AppData%\Roaming\Windows Azure PowerShell) に自動的に保存されます。新しい PowerShell セッションそれぞれで、最後のセッションで使用されたコンテキストが対象となります。

Azure コンテキストを管理できるコマンドレットを使用すると、きめ細かな制御も可能になります。変更を現在の PowerShell セッションのみ (Process スコープ) とすべての PowerShell セッション (CurrentUser スコープ) のどちらに適用するかを制御できます。これらのオプションについては、「コンテキストスコープの使用」で詳しく説明します。

バックグラウンドジョブとしての Azure PowerShell コマンドレットの実行

Azure Context Autosave 機能を使用すると、コンテキストを PowerShell のバックグラウンドジョブと共有することもできます。 PowerShell を使用すると、実行時間の長いタスクをバックグラウンドジョブとして開始および監視できます。タスクが完了するのを待つ必要はありません。資格情報をバックグラウンドジョブと共有するには、次の 2 つの方法があります。

コンテキストを引数として渡す

ほとんどの AzureRM コマンドレットでは、コンテキストをパラメーターとしてコマンドレットに渡すことができます。次の例に示すように、バックグラウンドジョブにコンテキストを渡すことができます。

$job = Start-Job { param ($ctx) New-AzureRmVm -AzureRmContext $ctx [... 追加パラメーター ...]} -ArgumentList (Get-AzureRmContext)


- Using the default context with Autosave enabled

If you have enabled **Context Autosave**, background jobs automatically use the default saved
context.

```powershell
$job = Start-Job { New-AzureRmVm [... Additional parameters ...]}

バックグラウンドタスクの結果を知っておく必要がある場合は、Get-Job を使用してジョブの状態を確認し、Wait-Job を使用してジョブの完了を待ちます。バックグラウンドジョブの出力をキャプチャまたは表示するには、Receive-Job を使用します。詳細については、「about_Jobs」を参照してください。

コンテキストの作成、選択、名前変更、削除

コンテキストを作成するには、Azure にサインインしている必要があります。 Connect-AzureRmAccount コマンドレット (またはそのエイリアス Login-AzureRmAccount) は、Azure PowerShell コマンドレットで使用される既定のコンテキストを設定し、資格情報で許可されているテナントまたはサブスクリプションへのアクセスを許可します。

サインイン後に新しいコンテキストを追加するには、Set-AzureRmContext (またはそのエイリアス Select-AzureRmSubscription) を使用します。

Set-AzureRMContext -Subscription 'Contoso Subscription 1' -Name 'Contoso1'

前の例では、現在の資格情報を使用して、"Contoso Subscription 1" を対象とした新しいコンテキストを追加します。新しいコンテキストの名前は "Contoso1" です。コンテキストに名前を指定しない場合は、アカウント ID とサブスクリプション ID を使用した既定の名前が使用されます。

既存のコンテキストの名前を変更するには、Rename-AzureRmContext コマンドレットを使用します。次に例を示します。

Rename-AzureRmContext '[user1@contoso.org; 123456-7890-1234-564321]' 'Contoso2'

この例では、自動的に [user1@contoso.org; 123456-7890-1234-564321] という名前の付いたコンテキストの名前を簡単な名前 "Contoso2" に変更します。コンテキストを管理するコマンドレットではタブ補完も使用されているため、コンテキストをすばやく選択できます。

最後に、コンテキストを削除するには、Remove-AzureRmContext コマンドレットを使用します。次に例を示します。

Remove-AzureRmContext Contoso2

"Contoso2" という名前のコンテキストは記憶されません。 Set-AzureRmContext を使用して、このコンテキストを再作成できます

資格情報の削除

Disconnect-AzureRmAccount (別名 Logout-AzureRmAccount) を使用して、ユーザーまたはサービスプリンシパルの資格情報と関連付けられたコンテキストをすべて削除できます。 Disconnect-AzureRmAccount コマンドレットをパラメーターを指定せずに実行すると、現在のコンテキストのユーザーまたはサービスプリンシパルに関連付けられた資格情報とコンテキストがすべて削除されます。特定のプリンシパルを対象とするために、ユーザー名、サービスプリンシパル名、またはコンテキストを渡すこともできます。

Disconnect-AzureRmAccount user1@contoso.org

コンテキストスコープの使用

場合によっては、他のセッションに影響を与えることなく、PowerShell セッションでコンテキストを選択、変更、または削除することもできます。コンテキストのコマンドレットの既定の動作を変更するには、Scope パラメーターを使用します。 Process スコープは、現在のセッションのみに適用されるようにすることで、既定の動作をオーバーライドします。逆に、CurrentUser スコープは、現在のセッションだけでなく、すべてのセッションのコンテキストを変更します。

たとえば、他のウィンドウに影響を与えることなく現在の PowerShell セッションの既定のコンテキストを変更したり、次にセッションを開いたときに使用されるコンテキストを変更したりするには、次を使用します。

Select-AzureRmContext Contoso1 -Scope Process

コンテキストの自動保存設定を記憶する方法

コンテキストの自動保存設定は、ユーザーの Azure PowerShell ディレクトリ (%AppData%\Roaming\Windows Azure PowerShell) に保存されます。コンピューターアカウントの中には、このディレクトリにアクセスできないものがあります。このようなシナリオでは、環境変数を使用できます。

$env:AzureRmContextAutoSave=$true

$true に設定すると、コンテキストは自動的に保存されます。 $false に設定した場合、コンテキストは保存されません。

AzureRM.Profile モジュールの変更点

コンテキスト管理用の新しいコマンドレット

Enable-AzureRmContextAutosave - PowerShell セッション間でのコンテキストの保存を許可します。変更するとグローバルコンテキストが変更されます。
Disable-AzureRmContextAutosave - コンテキストの自動保存をオフにします。新しい PowerShell セッションごとに再度サインインが必要になります。
Select-AzureRmContext - コンテキストを既定値として選択します。すべてのコマンドレットで、認証にこのコンテキストの資格情報が使用されます。
Disconnect-AzureRmAccount - アカウントに関連付けられた資格情報とコンテキストをすべて削除します。
Remove-AzureRmContext - 名前付きコンテキストを削除します。
Rename-AzureRmContext - 既存のコンテキストの名前を変更します。

既存のプロファイルコマンドレットの変更

Add-AzureRmAccount - サインインのスコープをプロセスまたは現在のユーザーにすることを許可します。認証後に既定のコンテキストに名前を付けることができます。
Import-AzureRmContext - サインインのスコープをプロセスまたは現在のユーザーにすることを許可します。
Set-AzureRmContext - 既存の名前付きコンテキストの選択と、プロセスまたは現在のユーザーへのスコープの変更を許可します。

PowerShell セッション間でユーザーの資格情報を保持する

Azure コンテキストの定義

次回サインインのためのコンテキストの自動保存

バックグラウンド ジョブとしての Azure PowerShell コマンドレットの実行