AzureResourceGroupDeployment@1 - Azure Resource Group Deployment v1 タスク

このタスクを使用して、Azure リソース グループをデプロイ、開始、停止、削除します。

このタスクは非推奨です。AzureResourceGroupDeployment@2を使用 します。

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

ConnectedServiceNameSelector - Azure 接続の種類
string. 使用できる値: ConnectedServiceName (Azure Resource Manager)、 ConnectedServiceNameClassic (Azure クラシック)。 既定値: ConnectedServiceName。

必須。 デプロイ用の Azure サブスクリプションを含むサービス接続を選択します。

ConnectedServiceName - Azure サブスクリプション
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

必須。 デプロイ用の Azure サブスクリプションを含むサービス接続を選択します。

ConnectedServiceNameClassic - Azure クラシック サブスクリプション
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。

デプロイ用の Azure クラシック サブスクリプションを選択します。

action - アクション
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。 使用できる値: 、、(Start Virtual Machines)、 Stop (Stop Virtual Machines) Restart 、(Restart Virtual Machines) Delete 、(Delete Virtual Machines)、(リソース グループの DeleteRG 削除)。 StartSelect Resource GroupCreate Or Update Resource Group 既定値: Create Or Update Resource Group。

Azure リソースまたはリソース グループに対して実行されるアクション。

actionClassic - アクション
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。 使用できる値: Select Resource Group ([クラウド サービス] を選択)。 既定値: Select Resource Group。

Azure リソースまたはクラウド サービスに対して実行されるアクション。

resourceGroupName - リソース グループ
string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

リソース グループの名前を提供します。

cloudService - クラウド サービス
string. ConnectedServiceNameSelector = ConnectedServiceNameClassic の場合に必要です。

クラウド サービスの名前を提供します。

location - 場所
string. action = Create Or Update Resource Group の場合に必要です。 使用できる値: Australia East、、、Brazil South、Canada Central、、Canada East、、 East US 2 West EuropeNorth Central USJapan WestNorth EuropeSouth Central USUK SouthSoutheast AsiaUK WestSouth IndiaWest Central USJapan EastWest US 2Central USWest USEast AsiaWest IndiaEast USCentral IndiaAustralia Southeast 既定値: East US。

リソース グループをデプロイする場所。 この値は、サブスクリプションにリソース グループが既に存在する場合は無視されます。

csmFile - テンプレート
string. action = Create Or Update Resource Group の場合に必要です。

Azure Resource Manager テンプレートを指すパスまたはパターンを指定します。 Azure Resource Manager テンプレートの詳細については、こちらを参照してください。 すぐに開始するには、 このサンプル テンプレートを使用します。

csmParametersFile - テンプレート パラメーター
string. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。

パラメーター ファイルの URL を指定します。 URL の例: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

プライベート ストレージ アカウントに格納されているファイルを使用するには、Shared Access Signature (SAS) トークンを取得してテンプレートの URL に含めます。 例: <blob_storage_url>/template.json?<SAStoken> パラメーター ファイルをストレージ アカウントにアップロードして SAS トークンを生成するには、 Azure ファイル コピー タスクを使用するか、 PowerShell または Azure CLI を使用して手順に従います。

グリッド内のテンプレート パラメーターを表示するには、[テンプレート パラメーターの … オーバーライド] テキスト ボックスの横にある をクリックします。 この機能を利用するには、ソースで CORS ルールが有効になっている必要があります。 テンプレートが Azure Storage BLOB 内にある場合は、「 クロスオリジン リソース共有 」を参照して CORS を有効にします。

overrideParameters - テンプレート パラメーターのオーバーライド
string. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。

オーバーライドするテンプレート パラメーターを指定します。

グリッド内のテンプレート パラメーターを表示するには、[パラメーターのオーバーライド] ボックスの ... 横にある をクリックします。 この機能を利用するには、ソースで CORS ルールが有効になっている必要があります。 テンプレートが Azure ストレージ BLOB 内にある場合は、この文字列を参照して CORS を有効にするか、テキスト ボックスにオーバーライドするテンプレート パラメーターを入力します。

例: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

パラメーター値に複数の単語がある場合は、変数を使用して値を渡す場合でも、単語を引用符で囲みます。 たとえば、「 -name "parameter value" -name2 "$(var)" 」のように入力します。 オブジェクト型パラメーターをオーバーライドするには、文字列化された JSON オブジェクトを使用します。 たとえば、「 -options ["option1"] -map {"key1": "value1" } 」のように入力します。

deploymentMode - デプロイ モード
string. action = Create Or Update Resource Group の場合に必要です。 使用できる値: Validation (検証のみ)、Incremental、。 Complete 既定値: Incremental。

このモードでは Incremental 、リソース グループへの増分更新としてデプロイが処理されます。 これは、リソース グループ内に存在していてもテンプレートで指定されていないリソースを未変更のまま残します。

Complete モードでは、テンプレートに含まれていないリソースが削除されます。 完全モードは、増分モードよりも比較的時間がかかります。 タスクがタイムアウトした場合は、タイムアウトを増やすか、モードに Incremental 変更することを検討してください。

Validate モードを使用すると、実際のリソースを作成する前にテンプレートに関する問題を見つけることができます。

デプロイ モードの詳細については、こちらを参照してください。

enableDeploymentPrerequisitesForCreate - 展開の前提条件を有効にする
boolean. 省略可能。 の場合は action = Create Or Update Resource Groupを使用します。 既定値: false。

リソース グループに仮想マシンが含まれている場合にのみ適用されます。

[デプロイ グループ] オプションを選択すると、各仮想マシンでデプロイ グループ エージェントが構成されます。

WinRM オプションを選択すると、自己署名証明書を使用して、ポート 5986 の HTTPS プロトコル経由で Windows リモート管理 (WinRM) リスナーが構成されます。 この構成は、Azure マシンでデプロイ操作を実行するために必要になります。 ターゲット仮想マシンがロード バランサーによってサポートされている場合は、ターゲット ポート (5986) に対して受信 NAT 規則が構成されていることを確認します。

enableDeploymentPrerequisitesForSelect - 展開の前提条件を有効にする
boolean. 省略可能。 の場合は action = Select Resource Groupを使用します。 既定値: false。

リソース グループに仮想マシンが含まれている場合にのみ適用されます。

[デプロイ グループ] オプションを選択すると、各仮想マシンでデプロイ グループ エージェントが構成されます。

WinRM オプションを選択すると、自己署名証明書を使用して、ポート 5986 の HTTPS プロトコル経由で Windows リモート管理 (WinRM) リスナーが構成されます。 この構成は、Azure マシンでデプロイ操作を実行するために必要になります。 ターゲット仮想マシンがロード バランサーによってサポートされている場合は、ターゲット ポート (5986) に対して受信 NAT 規則が構成されていることを確認します。

outputVariable - リソース グループ
string.

既存のリソース グループが選択されている場合は必須です。 リソース グループ変数の名前を提供します。 変数は、アプリケーションをデプロイするためのターゲット マシンの PowerShell タスクなど、後続のタスクでリソース グループを参照するために使用 $(variableName) できます。

選択したアクションが Create、、 Updateまたは Selectの場合にのみ有効です。

[なし] :