Windows Scripted Actions：使用法、サポートされている機能、考慮事項
概要
この記事では、Windows Scripted Actionsの使用法、サポートされている機能、重要な考慮事項に関する詳細情報を提供します。Windows Scripted Actionsは、指定された制約内でWindowsベースのシステム上でカスタムスクリプトを実行することを可能にし、パラメータ制御のためのさまざまなオプションを提供します。
注意: Windows Scripted Actionsの実行モデルはv5.3以降変更されたため、以前に使用されていたWindows Scripted Actionsが機能することを確認してください。この変更はREST APIにも影響します。「ScriptedActionsIds」フィールドの代わりに、Windows Scripted Actions のリストを渡す際は「ScriptedActions」を使用してください。ただし、後方互換性のため、従来通り「ScriptedActionsIds」フィールドも使用できますが、パラメータの受け渡しはできません。
カスタムWindows Scripted Actionsオプション
カスタムWindows Scripted Actionsオプションのサポートが利用可能です。これにより、特定の構成でWindowsスクリプトを実行できます。現在の制限とサポートされているオプションは次のとおりです：
Windowsスクリプトのみがサポートされています。Azure Runbooksはサポートされていません。
スクリプトは、個別または再起動付きの個別モードで実行できます。
カスタムスクリプトはCloud PCではサポートされていません。
Windows Scripted Actionsグループでのスクリプトの使用はサポートされていません。
PowerShellコードの検証
Windowsスクリプトには、保存時に基本的なPowerShellコードの検証が含まれています。この機能は、スクリプトのコードが構文的に正しいことを保証し、潜在的な問題を最小限に抑えるのに役立ちます。
サポートされているパラメータタイプとコントロール
Windows Scripted Actionsは、UI内で各パラメータタイプに対し、それぞれ専用のコントロールを提供する、さまざまなパラメータタイプをサポートしています。
`bool`、`switch`：チェックボックス
`byte`、`sbyte`、`ushort`、`short`、`int`、`uint`、`long`、`ulong`、`float`、`double`、`decimal`：各タイプの値の範囲を持つ数値入力
`char`、`string`：テキスト入力
`string[]`: Multi-select
サポートされている属性
スクリプト内で次の属性を使用できます：
`DisplayName`
`Description`
`Parameter`
`Mandatory`
「HelpMessage」（「Description」属性によって上書きされる、または上書きされる可能性があります）
`ParameterSetName`（現在はNerdio Managerの組み込みパラメータのみ）
「ValidateSet」（「string」タイプの場合、テキスト入力を単一選択に置き換えます；「string[]」の場合、利用可能なオプションを設定します）
JSONパラメータ定義
スクリプト内でJSON表記を使用してパラメータを定義できます。JSONパラメータ定義の構造は次のとおりです：
{
"parameter_name_1": {
"DisplayName": "string",
"Description": "string",
"IsRequired": "bool",
"Type": "string",
"OptionsSet": [
{ "Value": "スクリプトパラメータに渡される任意の値" }、
{ "Value": "Other value", "Label": "Display name for this option, optional" }
]
},
"parameter_name_2": { ... }
}
注意：すべてのパラメータ、JSON定義自体はオプションです。
組み込みNerdio Managerパラメータの使用
既定の変数は、既定でWindows Scripted Actionsに渡されます。ただし、カスタムパラメータを含める場合、これらの変数はParameterSetNameを使用して定義する必要があります。さもなければ、スクリプトアクションに含まれます。
組み込みのNerdio Managerパラメーター（`$AzureRegionName` や `$AzureSubscriptionName` を含む）を使用するには、次のようにします：
"param" ブロックを省略すると、古い動作が適用され、自動的に組み込みパラメーターがスクリプトに渡されます。
必要な組み込みパラメーターを「param」ブロックに、適切な名前（ツールチップに記載されている通り）、タイプ（ほとんどの場合は「string」、`$SecureVars`の場合は「object」）で追加し、`ParameterSetName = "NME_PARAMETER"` を指定してください。
この場合、パラメーターは UI では非表示ですが、Nerdio Manager によってスクリプトに自動的に渡されます。
param (
[Parameter(ParameterSetName="NME_PARAMETER")]
[string] $AzureRegionName
)
重要な考慮事項
さまざまなシナリオでWindows Scripted Actionsの正しい動作を確認してください：
ホストでWindows Scripted Actionsを実行します。
ホストで一括してWindows Scripted Actionsを実行します。
電源をオフにしてイメージとして設定します。
デスクトップイメージでWindows Scripted Actionsを実行します。
ライブラリからデスクトップイメージを作成します。
VMからデスクトップイメージを作成します。
デスクトップイメージをクローン作成します。
ホストプールのプロパティ -> VM 展開タブ。
追加のリソース
使用例や新しいスクリプトへのアクセスは、リリース後に新しいスクリプトが追加されたメインリポジトリを参照してください。
コメント (0件のコメント)