Scripted Actions の概要

Avatar
Nerdio Product Support

スクリプトアクションは、Windows VM または Azure Automation アカウントのコンテキストで実行される PowerShell スクリプトです。Scripted Actions を使用して、Nerdio Manager の機能を拡張およびカスタマイズできます。Nerdio Manager には、$VMName など、PowerShell コードで使用できるいくつかの事前入力済み変数が用意されています。

Nerdio Manager

Nerdio Manager

Scripted Actions は、Azure または AVD 仮想マシンで実行できる PowerShell スクリプトのライブラリとして機能し、 Nerdio Manager

新しいScripted Actionを作成する

新しいスクリプトアクションを作成する手順は以下のとおりです。

  1. Endpoints > Automation > Scripted Actions に移動します。

  2. [Windows スクリプト] または [Azure Runbook] のいずれかを選択します。

  3. [Scripted Actionを追加] を選択します。

  4. 次の情報を入力してください：

    • 名前 スクリプトの名前を入力します。この名前は、利用可能なスクリプトアクションのリストからこのアクションを選択したときに表示されます。

    • 説明スクリプトの説明を入力します。

    • タグタグ: ドロップダウンリストからスクリプトのオプションタグを選択します。これらのタグは、検索と整理に使用されます。

    • スクリプト実行モードドロップダウンリストからスクリプトの実行モードを選択します。

      注記

      このパラメーターは、 Nerdio ManagerScripted Actions を VM に渡す際の動作を決定します。 Nerdio Manager は、Azure Custom Script Extension を使用して最終的に PowerShell コマンドを実行します。（Windows 向けの Scripted Actions の詳細は、 Custom Script for Windows を参照してください。）拡張機能は、 Nerdio Manager

      • 結合結合: スクリプトを他のスクリプトと安全に結合できるものとしてマークします。この例として、レジストリ値を追加するスクリプトがあります。

      • 個別個別: 単独で実行する必要があるアクション用のスタンドアロンスクリプトです。この例として、他のスクリプトと競合する可能性のある汎用的な変数名を持つ長いスクリプトや、新しい PowerShell セッションを必要とするスクリプトがあります。

      • 個別 (再起動あり)Windows スクリプトの場合、スクリプトをスタンドアロンモードで実行し、完了時に再起動します。

      • 実行タイムアウト:個別モードの Azure Runbook の場合、Scripted Action の実行タイムアウト (分単位) を入力します。

    • Cloud PC を有効化オプションで、Windows スクリプトの場合、このオプションをオンにして Cloud PC スクリプトポリシーを作成します。

      • ログオンしている資格情報を使用してこのスクリプトを実行する:このオプションを選択すると、クライアントコンピューター上のユーザーの資格情報を使用してスクリプトを実行します。既定では、スクリプトはシステムコンテキストで実行されます。

      • スクリプト署名チェックを適用このオプションを選択すると、スクリプトは信頼できる発行者による署名が必須となります。既定では、警告やプロンプトは表示されず、スクリプトはブロックされずに実行されます。

      • 64 ビット PowerShell ホストでスクリプトを実行する:このオプションを選択すると、64 ビットクライアントアーキテクチャ用の 64 ビット PowerShell ホストでスクリプトを実行します。

      • すべてのユーザーに割り当てる:このオプションを選択すると、スクリプトをすべてのユーザーに割り当てます。

      • すべてのデバイスに割り当てる:このオプションを選択すると、スクリプトをすべてのデバイスに割り当てます。

      • 選択したグループに割り当てる:ドロップダウンリストから、このスクリプトを割り当てるグループを選択します。

      • 割り当てを除外する:ドロップダウンリストから、このスクリプトを除外するグループを選択します。

    • スクリプトスクリプト: 実行する PowerShell コマンドを入力します。

      注記

      Nerdio Manager

      注記

      注: このコードで使用する Cmdlet は、VM または Azure Automation アカウントで利用できる必要があります。Windows VM または Azure Automation アカウントにデフォルトで存在しないモジュールのPowerShell cmdlet を使用する場合、最初にモジュールをインストールする必要があります。

      Nerdio は、スクリプトコードで使用できる、あらかじめ入力済みの変数を提供します。利用可能な変数は次のとおりです。

      • $HostPoolId (スクリプトがホストプールに関連付けられている場合に利用可能)

      • $HostPoolName (スクリプトがホストプールに関連付けられている場合に利用可能)

      • $AzureSubscriptionId

      • $AzureSubscriptionName

      • $AzureResourceGroupName

      • $AzureRegionName

      • $AzureVMName (スクリプトが VM に関連付けられている場合に利用可能)

      • $ADUsername (AD 資格情報を渡す場合)

      • $ADPassword (AD 資格情報を渡す場合)

      • $DesktopUser (スクリプトが個人用ホストプールに関連付けられている場合に利用可能)

      ヒント

      ヒント: VSCode や ISE などの IDE を使用してコードを開発することをお勧めします。次に、専用の開発セッションホスト /Azure VM で PowerShell コードをテストします。

  5. 必要な情報をすべて入力したら、[保存して閉じる] を選択します。

既存のスクリプトアクションを表示、編集する

Nerdio Manager

既存のスクリプトアクションを表示および編集する手順は以下のとおりです。

  1. Endpoints > Automation > Scripted Actions に移動します。

  2. [Windows スクリプト] または [Azure Runbook] のいずれかを選択します。

  3. 作業したいスクリプトアクションを特定して、[編集する] を選択します。

  4. 必要に応じて、適切に変更を行い、[保存して閉じる] を選択します。

Scripted Actionのクローン作成を行います。

Nerdio Manager

Scripted Actionのクローン作成を行う手順は以下のとおりです。

  1. Endpoints > Automation > Scripted Actions に移動します。

  2. [Windows スクリプト] または [Azure Runbook] のいずれかを選択します。

  3. クローン作成するスクリプトアクションを特定して、アクションメニューから [クローン作成] を選択します。

  4. 必要な変更をすべて行い、[クローン作成] を選択します。

Scripted Action Groups

Scripted Action Groups により、管理者はスクリプトのコレクションを作成し、標準的な展開タスクの際にそれらを割り当てることができます。詳細については、「Scripted Action Groups」を参照してください。

Scripted Actions を適用する

Scripted Actions は、次のタスクの一部として使用できます。

  • VM ライフサイクルイベント:セッションホスト VM のプロビジョニングや再イメージ化中、または VM が停止や開始されるときに実行されます。セッションホストが作成、破棄、停止、または開始されるたびに、スクリプトアクションが最終ステップとして実行されます。ホストの再イメージ化の詳細については、「ホストプールのサイズ変更または再イメージ化」を参照してください。

  • スクリプトを実行ホストプールに対して手動でコマンドを実行します。これは、すべてのセッションホストを完全に再イメージ化せずに変更する必要がある場合に便利です(例として、レジストリキーを変更するスクリプトなどがあります）。詳細については、「一括ホストスクリプトアクションの実行」を参照してください。

設定したスクリプトアクションを AVD ホスト VM ライフサイクルイベントに適用する手順は以下のとおりです。

  1. 作業したいホストプールを見つけます。

  2. アクションメニューから、[プロパティ] > [VM 展開] を選択します。

  3. [次の場合にスクリプトアクションを実行する] の希望するオプションをオンにします。

  4. 各オプションについて、次の情報を入力します。

    • スクリプトスクリプト: ドロップダウンリストから実行するスクリプトを選択します。

    • Scripted Actions 入力パラメーター:必要に応じて、必要なパラメータを提供してください。

    • AD 資格情報を渡す :このオプションを選択して、AD 資格情報を変数としてスクリプトに渡します。

    • AD 資格情報:ドロップダウンリストから、渡す AD 資格情報を選択します。

  5. 必要な情報をすべて入力したら、[保存して閉じる] を選択します。

    スクリプトアクションは、このホストプールのスクリプトアクションのリストに追加されます。

警告

Nerdio Manager 一部の自動化では、必要なアクションを VM 自体の外、Azure のコンテキストで実行する必要があります。これらのコマンドは、Azure PowerShell モジュールがインストールされたセッションホスト VM で実行できますが、Azure をターゲットとするセッションホスト VM でスクリプトを実行することは効率が悪く、信頼性が低くなる可能性があります。Azure Automation は一貫した実行を可能にし、 Nerdio Manager

Azure スクリプトのトラブルシューティングに関する情報については、「スクリプトのトラブルシューティング」を参照してください。

ホストプールで [スクリプトを実行] オプションを使用してスクリプトアクションを実行する手順は以下のとおりです。

  1. 作業したいホストプールを見つけます。

  2. アクションメニューから、[ホスト] > [スクリプトを実行] を選択します。

  3. 次の情報を入力してください：

    • ... 内のすべての VM に対して以下の Scripted Actions を実行します:ドロップダウンリストから、適用する Scripted Actions を選択します。

    • Scripted Actions 入力パラメーター:必要に応じて、必要なパラメータを提供してください。

    • AD 資格情報を渡す :このオプションを選択して、AD 資格情報を渡します。

    • AD 資格情報:ドロップダウンリストから、渡す AD 資格情報を選択します。

    • Scripted Actions 実行後に VM を再起動する:スクリプトの実行後に VM を再起動するには、このオプションを選択します。スクリプトによってコンピューターが再起動されると、カスタムスクリプト拡張機能が正常に動作しなくなるため、PowerShell の再起動コマンドを使用するよりも、このオプションを使用することをお勧めします。

    • ホストを処理するグループ単位:この一括操作で実行する同時実行アクションの数を入力します。

    • 中止するまでの失敗回数:プロセスを停止させる失敗の数を入力します。

    • スケジュール:スケジュール: スケジュールをオンにして、スケジュール情報を入力し、スケジュールに従ってスクリプトを実行できるようにします。

    • メッセージングメッセージングをオンにして、アクティブなユーザーにメッセージを送信します。

      • 遅延 遅延: ドロップダウンリストから、メッセージ送信後にプロセスを開始するまで待機する分数を選択します。

      • メッセージメッセージ: ユーザーに送信したいメッセージを入力します。

  4. 必要な情報をすべて入力したら、[保存して閉じる] を選択します。

関連トピック

ホストプールのサイズ変更または再イメージ化

一括ホストスクリプトアクションの実行

Windows スクリプト用 Scripted Actions

Azure Runbook 用 Scripted Actions

スクリプトのトラブルシューティング

この記事は役に立ちましたか？

0人中0人がこの記事が役に立ったと言っています
他にご質問がございましたら、リクエストを送信してください

関連記事

コメント (0件のコメント)

サインインしてコメントを残してください。