既存の Runbook とモジュールを使用する
Azure Automation で独自の Runbook およびモジュールを作成するのではなく、マイクロソフトやコミュニティによって既に作成されているシナリオにアクセスできます。 PowerShell Runbook と Python Runbook は Azure portal 内の Runbook ギャラリーから、モジュールと Runbook (Azure に固有のものとそうでないものがあります) は PowerShell ギャラリーから取得できます。 開発したシナリオを共有することにより、コミュニティに貢献することもできます。
Note
TechNet スクリプト センターは廃止されています。 Runbook ギャラリーのスクリプト センターにあるすべての Runbook が Automation GitHub 組織に移動されました。詳細については、「GitHub への Azure Automation Runbook の移動」を参照してください。
Azure portal を使用して GitHub から Runbook をインポートする
Note
- Azure portal の [ギャラリーの参照] オプションでは、ユーザー エクスペリエンスが強化されています。
- [プロセス オートメーション]>[Runbook] ブレードでは、[Runbook のインポート] または [ギャラリーの参照] オプションを使用して Runbook をインポートできます。[Runbook] ページには、[ランタイム バージョン] と [Runbook の種類] という 2 つの新しい列が表示されます。
Azure portall で、Automation アカウントを開きます。
[プロセス オートメーション] の [Runbook] ブレードを選択します。
[Runbook] ページで [Runbook のインポート] をクリックします。
[Runbook のインポート] ページでは、[ファイルの参照] を使用してローカル コンピューターに格納されているファイルをインポートするか、または [ギャラリーで参照] を使用して GitHub からファイルをインポートすることができます。
ファイルを選択します。
[名前]、[ランタイム バージョン]、[説明] を入力します。
[インポート] をクリックします。
または、[Runbook] ページで [ギャラリーの参照] を選択して、使用可能な Runbook を参照します。
リストの上にあるフィルターを使用して、発行元や種類で表示を絞り込んだり、並べ替えたりすることができます。 必要なギャラリー アイテムを探し、選択して詳細を表示します。
[選択] をクリックして、選んだ Runbook を選択します。
[Runbook のインポート] ページで、[名前] を入力し、[ランタイム バージョン] を選択します。
[Runbook の種類] と [説明] は、自動的に設定されます。
[インポート] をクリックします。
Automation アカウントの [Runbook] タブに Runbook が表示されます。
PowerShell ギャラリーの Runbook
重要
PowerShell ギャラリーから取得した Runbook の内容を検証する必要があります。 運用環境で Runbook をインストールおよび実行するときは細心の注意を払ってください。
PowerShell ギャラリーでは、Microsoft やコミュニティからさまざまな Runbook が提供されており、それを Azure Automation にインポートできます。 使用するには、ギャラリーから Runbook をダウンロードするか、Azure portal でギャラリーから、または Automation アカウントから、Runbook を直接インポートできます。
Note
PowerShell ギャラリーではグラフィカル Runbook はサポートされていません。
PowerShell ギャラリーから直接インポートできるのは、Azure portal を使用した場合のみです。 PowerShell を使用してこの機能を実行することはできません。 手順は、「Azure portal を使用して GitHub から PowerShell Runbook をインポートする」に示されている手順と同じですが、ソースは PowerShell ギャラリーになります。
PowerShell ギャラリーのモジュール
PowerShell モジュールには、Runbook で使用できるコマンドレットが含まれています。 Azure Automation でインストールできる既存のモジュールは PowerShell ギャラリーから入手できます。 このギャラリーは Azure portal から起動できます。また、モジュールを Azure Automation に直接インストールするか、手動でダウンロードしてインストールすることができます。
インポートするモジュールを Azure portal で探すこともできます。 Automation アカウント用のモジュールは、[共有リソース] の下の [モジュール] に一覧表示されます。
重要
Az モジュールを使用して実行するように設計されたスクリプトには、キーワード "AzureRm" を含めないでください。 たとえコメントであっても、このキーワードを含めると、AzureRm が読み込まれ、Az モジュールと競合する可能性があります。
PowerShell ギャラリーで使用できる一般的なシナリオ
以下の一覧には、一般的なシナリオをサポートするいくつかの Runbook が含まれています。 Azure Automation チームによって作成された Runbook の詳細な一覧については、AzureAutomationTeam のプロファイルのページを参照してください。
- Update-ModulesInAutomationToLatestVersion - すべてのモジュールの最新バージョンを PowerShell ギャラリーから Automation アカウントにインポートします。
- Enable-AzureDiagnostics - ジョブの状態とジョブ ストリームを含む Azure Automation ログを受信するように Azure Diagnostics と Log Analytics を構成します。
- Copy-ItemFromAzureVM - Windows Azure 仮想マシンからリモート ファイルをコピーします。
- Copy-ItemToAzureVM - ローカル ファイルを Azure 仮想マシンにコピーします。
コミュニティに貢献する
Azure Automation コミュニティに貢献し、成長を支援することを強くお勧めします。 作成済みの優れた Runbook をコミュニティで共有しましょう。 ご協力をお願いいたします。
GitHub Runbook ギャラリーに Runbook を追加する
この GitHub ワークフローを使用して、新しい PowerShell Runbook または Python Runbook を Runbook ギャラリーに追加できます。
GitHub でパブリック リポジトリを作成し、Runbook とその他の必要なファイル (readme.md、description など) を追加します。
リポジトリがサービスによって検出されるように、トピック
azureautomationrunbookgalleryを追加します。これで、リポジトリを Automation Runbook ギャラリーに表示できます。作成した Runbook が PowerShell ワークフローの場合は、トピック
PowerShellWorkflowを追加します。 Python 3 Runbook の場合は、Python3を追加します。 Azure Runbook に必要なトピックは他にありませんが、Runbook ギャラリーにおける分類と検索に使用可能なその他のトピックを追加することをお勧めします。Note
使用する可能性のある書式設定、ヘッダー、既存のタグ (例:
Azure Automation、Linux Azure Virtual Machines) などの項目について、ギャラリー内の既存の Runbook を確認してください。
既存の Runbook に対する変更を提案するには、その Runbook に対して pull request を送信します。
既存の Runbook を複製して編集する場合は、Runbook に別の名前を付けることをお勧めします。 古い名前を再利用すると、Runbook ギャラリーの一覧に同じ名前が 2 つ表示されます。
Note
更新された Runbook と新しい Runbook の両方について、GitHub と Automation Runbook ギャラリー間の同期のための時間を少なくとも 12 時間は見込んでおいてください。
PowerShell ギャラリーに PowerShell Runbook を追加する
他のユーザーにも役に立つと思われる Runbook を PowerShell ギャラリーに追加してください。 PowerShell ギャラリーでは、PowerShell モジュールと PowerShell スクリプトを受け付けています。 Runbook を追加するには、PowerShell ギャラリーにアップロードします。
Azure portal でモジュール ギャラリーからモジュールをインポートする
Azure portall で、Automation アカウントを開きます。
[共有リソース] の下にある [モジュール] を選択します。
[モジュール] ページで、[ギャラリーの参照] を選択して、モジュールの一覧を開きます。
[ギャラリーを参照] ページで、次のフィールドで検索できます。
- モジュール名
- タグ
- Author
- コマンドレット/DSC リソース名
目的のモジュールを探し、選択して詳細を表示します。
特定のモジュールにドリルダウンすると、詳細を表示できます。 この情報には、PowerShell ギャラリーへのリンク、必要な依存関係、モジュールに含まれるすべてのコマンドレットまたは DSC リソースが含まれています。
モジュールを Azure Automation に直接インストールするには、[インポート] をクリックします。
[インポート] ペインに、インポートするモジュールの名前が表示されます。 すべての依存関係がインストールされている場合は、[OK] ボタンがアクティブになります。 依存関係が存在しない場合は、このモジュールをインポートする前に、その依存関係をインポートする必要があります。
[インポート] ペインで [OK] をクリックしてモジュールをインポートします。 Azure Automation がモジュールをアカウントにインポートしている間に、モジュールとコマンドレットについてのメタデータが抽出されます。 各アクティビティを抽出する必要があるため、このアクションには数分かかる場合があります。
モジュールをデプロイ中であることが最初に通知され、プロセスが完了すると完了通知が表示されます。
モジュールがインポートされた後は、使用可能なアクティビティを確認できます。 Runbook のモジュール リソースと DSC リソースを使用できます。
Note
PowerShell Core だけをサポートするモジュールは、Azure Automation でサポートされておらず、Azure portal にインポートしたり、PowerShell ギャラリーから直接展開したりすることはできません。
Runbook またはモジュールを要求する
ユーザーの声に要求を送信できます。 Runbook の作成について支援が必要な場合、または PowerShell について質問がある場合は、Microsoft Q&A 質問ページに質問を投稿してください。
次のステップ
- PowerShell Runbook の使用を開始するには、「チュートリアル: PowerShell Runbook を作成する」を参照してください。
- Runbook を操作するには、「Azure Automation で Runbook を管理する」を参照してください。
- PowerShell スクリプトの詳細については、PowerShell のドキュメントを参照してください。
- PowerShell コマンドレットのリファレンスについては、「Az.Automation」をご覧ください。