システム割り当てマネージド ID を Azure 仮想マシン、Arc 対応サーバー、Arc 対応 VMware vSphere VM または Arc 対応 SCVMM VM で有効にする必要があります。 システム割り当てマネージド ID が有効になっていない場合は、追加プロセスの一環として有効になります。
サポートされるオペレーティング システム
Windows (x64)
Linux (x64)
● Windows Server 2022 (Server Core を含む) ● Windows Server 2019 (Server Core を含む) ● Windows Server 2016、バージョン 1709 および 1803 (Server Core を除く) ● Windows Server 2012、2012 R2 (Server Core を除く) ● Windows 10 Enterprise (マルチセッションを含む) および Pro
● Debian GNU/Linux 8,9, 10 および 11 ● Ubuntu 18.04 LTS、20.04 LTS および 22.04 LTS ● SUSE Linux Enterprise Server 15.2 および 15.3 ● Red Hat Enterprise Linux Server 7、8、9 ● SUSE Linux Enterprise Server (SLES) 15 ● Rocky Linux 9 ● Oracle Linux 7、8 ハイブリッド worker 拡張機能は、OS ベンダーのサポート タイムラインに従います。
その他の要件
Windows (x64)
Linux (x64)
Windows PowerShell 5.1 (WMF 5.1 をダウンロードする)。 PowerShell Core はサポートされていません。
Azure VM と Arc 対応サーバーの場合、PowerShell コマンドレットまたは API を使ってプロキシ設定を指定することができます。 現在、この方法は Arc 対応 VMware vSphere VM ではサポートされていません。
コマンドレットを使用して拡張機能をインストールするには:
以下の API 呼び出しを使って、Automation アカウントの詳細を取得します。
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}?api-version=2021-06-22
この API 呼び出しで、キー AutomationHybridServiceUrl の値が提供されます。 その URL を次の手順で使って、VM 上で拡張機能を有効にします。
ハイブリッド worker 拡張機能を VM にインストールするには、次の PowerShell コマンドレットを実行します (必須モジュール: Az.Compute)。 先ほどの API 呼び出しで提供された properties.automationHybridServiceUrl を使用します
Azure VM または Arc 対応のサーバーが必要になります。 こちらの手順に従って Arc 接続マシンを作成することができます。
ハイブリッド worker 拡張機能をインストールして使う
REST API を使ってハイブリッド worker 拡張機能をインストールして使うには、次の手順を実行します。 この例では、米国中西部リージョンについて取り上げます。
次の API 呼び出しを行って、ハイブリッド worker グループを作成します。
PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22
要求の本文には、次の情報を含める必要があります。
{
}
PUT の応答で、ハイブリッド worker グループが作成されたかどうかを確認します。 再確認するには、次のようにハイブリッド worker グループに対して GET 呼び出しをもう一度行う必要があります。
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}?api-version=2021-06-22
次の API 呼び出しを使って、VM を先ほど作成したハイブリッド worker グループに接続します。 呼び出しを行う前に、hybridRunbookWorkerId として使われる新しい GUID を生成します。
PUT https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22
PUT 呼び出しの応答で、ハイブリッド worker グループが作成されたかどうかを確認します。 再確認するには、次のようにハイブリッド worker に対して GET 呼び出しをもう一度行う必要があります。
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/hybridRunbookWorkerGroups/{hybridRunbookWorkerGroupName}/hybridRunbookWorkers/{hybridRunbookWorkerId}?api-version=2021-06-22
GET https://westcentralus.management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/HybridWorkerExtension?api-version=2021-06-22
この API 呼び出しで、キー AutomationHybridServiceUrl の値が提供されます。 その URL を次の手順で使って、VM 上で拡張機能を有効にします。
次の API 呼び出しを使用して、Azure VM に Hybrid Worker 拡張機能をインストールします。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/extensions/HybridWorkerExtension?api-version=2021-11-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions/{extensionName}?api-version=2021-05-20