各 Automation アカウントでは、最も一般的な PowerShell モジュールが既定で提供されます。 「既定のモジュール」を参照してください。 Azure チームが Azure モジュールを定期的に更新すると、含まれているコマンドレットで変更が発生する可能性があります。 こうした変更 (パラメーター名の変更、コマンドレット全体の非推奨化など) により、Runbook に悪影響が及ぶ可能性があります。
メモ
グローバル モジュールを削除することはできません。これらは、Automation で提供されるそのまま利用できるモジュールです。
重要
新しいランタイム環境エクスペリエンスでジョブ実行環境を構成できるようにすると、モジュールとパッケージを管理できます。 新しいエクスペリエンスでは、[モジュール] と [パッケージ] のブレードは使用できません。 モジュールとパッケージを管理するには、「ランタイム環境と関連する Runbook を管理する」を参照してください。
Automation アカウントをセットアップする
Runbook やそれにより自動化されるプロセスに影響を与えないようにするため、更新前にテストと検証を必ず行ってください。 その目的のための専用の Automation アカウントがない場合は、アカウントの作成を検討してください。アカウントを作成すると、Runbook の開発中の多数のさまざまなシナリオについてテストを行うことができます。 このテストで、PowerShell モジュールの更新など、反復的な変更を行ってください。
Automation アカウントのシステム割り当てマネージド ID またはユーザー割り当てマネージド ID が追加されていることを確認してください。
スクリプトをローカルで開発する場合、テスト時に確実に同じ結果が得られるようにするために、Automation アカウントに置いているものと同じバージョンのモジュールをローカルに用意することをお勧めします。 結果を検証し、必要な変更を適用した後、変更を運用環境に移行してください。
メモ
新しい Automation アカウントには、最新のモジュールが含まれていない可能性があります。
Az モジュールを更新する
次のセクションでは、ポータル (推奨) または Runbook を使用して Az モジュールを更新する方法について説明します。
ポータルを使用して Az モジュールを更新する
現在、AZ モジュールはポータルからのみ更新できます。 PowerShell と ARM テンプレートからの更新は、今後できるようになる予定です。 次の手順では、既定の Az モジュールのみが更新されます。
Azure ポータルにサインインし、Automation アカウントに移動します。
[共有リソース] の下にある [モジュール] を選択します。
[Update Az modules](Az モジュールを更新する) を選択します。
[Module to Update]\(更新するモジュール\) を選択します。 既定では、Az モジュールが表示されます。
ドロップダウン リストから [モジュール バージョン] と [ランタイム バージョン] を選択します
[更新] を選択し、選択したバージョンに Az モジュールを更新します。 [モジュール] ページでは、次のように一覧を表示できます。
Automation アカウントにインポートされた既存の Az モジュールのバージョンよりも下位のバージョンを選択した場合、更新操作で、選択した下位バージョンへのロールバックが実行されます。
更新操作は、[PowerShell モジュール] の下のモジュール一覧に表示されている更新されたモジュールから、モジュールのバージョンと状態のプロパティを確認できます。
Azure チームは、モジュールのバージョンを定期的に更新し、ドロップダウン リストからモジュールのバージョンを選択して、default Az モジュールを更新するオプションを提供します。
Runbook を使用して Az モジュールを更新する
Automation アカウントのAzure モジュールを更新するには:
- open sourceとして使用できる Update-AutomationAzureModulesForAccount Runbook を使用します。
- GitHub リポジトリからダウンロードして、この Runbook を使用してAzure モジュールを更新します。
- それを Automation アカウントにインポートするか、スクリプトとして実行します。 Automation アカウントに Runbook をインポートする方法については、Runbook のインポートに関する記事をご覧ください。
メモ
Azure ポータルを使用して Az モジュールを更新することをお勧めします。
Update-AutomationAzureModulesForAccount スクリプトを使用してこれを実行することもできます。これは、オープンソースとして使用でき、参照として提供されます。 ただし、Runbook でエラーが発生した場合は、必要に応じて Runbook のパラメーターを変更するか、シナリオに従ってスクリプトをデバッグする必要があります。
Update-AutomationAzureModulesForAccount Runbook では、Azure、AzureRM、Az モジュールの更新が既定でサポートされています。 Az の更新の詳細については、Update Azure モジュール Runbook README を確認してください。 このランブックを使用したオートメーションモジュール。 Automation アカウントで Az モジュールを使用する場合は、考慮する必要があるもう 1 つの重要な要素があります。 詳細については、Azure Automation の
更新の Runbook コードを通常の PowerShell スクリプトとして使用する
Runbook のコードは、Runbook としてではなく、通常の PowerShell スクリプトとして使用することができます。 これを行うには、最初に Connect-AzAccount コマンドレットを使用してAzureにサインインしてから、-Login $false をスクリプトに渡します。
更新の Runbook をソブリン クラウドで使用する
ソブリン クラウドでこの Runbook を使用するには、AzEnvironment パラメーターを使用して、適切な環境を Runbook に渡します。 使用できる値は、AzureCloud (パブリック クラウドAzure)、AzureChinaCloud、AzureGermanCloud、AzureUSGovernment です。 これらの値は Get-AzEnvironment | select Name を使用して取得できます。 このコマンドレットに値を渡さないと、Runbook は既定で AzureCloud を使用します。
更新用 Runbook を使用して特定のモジュールのバージョンを更新する
PowerShell Galleryで使用できる最新のモジュールではなく、特定のAzure PowerShell モジュール バージョンを使用する場合は、これらのバージョンを ModuleVersionOverrides Runbook の省略可能な パラメーターに渡します。 例については、Update-AutomationAzureModulesForAccount.ps1 Runbook を参照してください。
ModuleVersionOverrides パラメーターに記載されていないAzure PowerShellモジュールは、PowerShell Galleryの最新のモジュール バージョンで更新されます。
ModuleVersionOverrides パラメーターに何も渡さなかった場合、すべてのモジュールがPowerShell Galleryの最新のモジュール バージョンで更新されます。 この動作は、Azure ポータルの Update Azure Modules ボタンでも同じです。
次のステップ
- モジュールの使用の詳細については、Azure Automation の
Manage モジュールに関するページを参照してください。 - 更新 Runbook の詳細については、「Update Azure modules Runbookを参照してください。
- Azure Automationで共有リソースとして管理Azure PowerShellモジュールを更新するときの問題のトラブルシューティングについては、「共有リソースの問題Azure Automationトラブルシューティングを参照してください。