Microsoft.DevTestLab ラボ/virtualmachines 2016-05-15

• 最新の を する
• 2018-09-15
• 2016-05-15
• 2015-05-21-プレビュー

Bicep リソース定義

ラボ/virtualmachines リソースの種類は、次をターゲットとする操作でデプロイできます。

• リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevTestLab/labs/virtualmachines リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
      }
      tags: {
        {customized property}: 'string'
      }
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

名前	形容	価値
場所	リソースの場所。	糸
名前	リソース名	string (必須)
親	Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 子リソース」を参照してください。	種類のリソースのシンボリック名: ラボ
プロパティ	リソースのプロパティ。	LabVirtualMachineProperties (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください

適用スケジュール

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ApplicableScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

ApplicableScheduleプロパティ

名前	形容	価値
labVmsシャットダウン	自動シャットダウン スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の
labVmsスタートアップ	自動起動スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の

アーティファクトデプロイメントステータスプロパティ

名前	形容	価値
アーティファクト適用済み	正常に適用された成果物の合計数。	整数 (int)
deploymentStatus(デプロイメントステータス)	成果物のデプロイ状態。	糸
totalArtifacts (合計アーティファクト)	仮適用された成果物の合計数。	整数 (int)

アーティファクトインストールプロパティ

名前	形容	価値
artifactId（アーティファクト識別子）	成果物の識別子。	糸
deploymentStatusMessage (デプロイメントステータスメッセージ)	デプロイからのステータス メッセージ。	糸
インストール時間	アーティファクトが仮想マシンへのインストールを開始する時間。	糸
パラメーター	成果物のパラメーター。	アーティファクトパラメータプロパティ[]
地位	成果物の状態。	糸
vmExtensionStatusMessage	仮想マシン拡張機能からのステータス メッセージ。	糸

アーティファクトパラメータプロパティ

名前	形容	価値
名前	アーティファクト パラメーターの名前。	糸
価値	アーティファクト パラメーターの値。	糸

コンピュートデータディスク

名前	形容	価値
ディスクサイズGiB	GiB 単位のデータ ディスク サイズを取得します。	整数 (int)
diskUri (英語)	BLOB によってバックアップされる場合、基になる BLOB の URI。	糸
managedDiskId の	マネージド ディスクによってバックアップされる場合、これはコンピューティング ディスク リソースの ID です。	糸
名前	データ ディスク名を取得します。	糸

ComputeVmInstanceViewステータス

名前	形容	価値
コード	状態コードを取得します。	糸
ディスプレイステータス	状態の短いローカライズ可能なラベルを取得します。	糸
メッセージ	状態に関連付けられているメッセージを取得します。	糸

ComputeVmProperties の

名前	形容	価値
データディスクID	仮想マシンのデータ ディスク BLOB URI を取得します。	文字列[]
データディスク	仮想マシンに接続されているすべてのデータ ディスクを取得します。	コンピュートデータディスク[]
ネットワークインターフェイスID	仮想マシンのネットワーク インターフェイス ID を取得します。	糸
osDiskId(英語)	仮想マシンの OS ディスク BLOB URI を取得します。	糸
osTypeの	仮想マシンの OS の種類を取得します。	糸
ステータス	仮想マシンの状態を取得します。	ComputeVmInstanceViewStatus[]
vmサイズ	仮想マシンのサイズを取得します。	糸

曜日詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸

ギャラリー画像参照

名前	形容	価値
提供	ギャラリー イメージのオファー。	糸
osTypeの	ギャラリー イメージの OS の種類。	糸
発行者	ギャラリー イメージの発行元。	糸
エスケーユー	ギャラリー イメージの SKU。	糸
バージョン	ギャラリー イメージのバージョン。	糸

時間詳細

名前	形容	価値
分	スケジュールが実行される時間の分数。	整数 (int)

InboundNatRule (英語)

名前	形容	価値
バックエンドポート	外部トラフィックがリダイレクトされるポート。	整数 (int)
フロントエンドポート	受信接続の外部エンドポイント ポート。 指定できる値の範囲は、1 ~ 65535 です。 指定しない場合、値は自動的に割り当てられます。	整数 (int)
トランスポートプロトコル	エンドポイントのトランスポート プロトコル。	'TCP' 「ウディプ」

LabVirtualMachineプロパティ

名前	形容	価値
allowClaim(許可要求)	別のユーザーが仮想マシンの所有権を取得できるかどうかを示します	ブール (bool)
該当スケジュール	仮想マシンに適用されるスケジュール。	適用スケジュール
アーティファクトデプロイメントステータス	仮想マシンの成果物のデプロイ状態。	アーティファクトデプロイメントステータスプロパティ
成果 物	仮想マシンにインストールする成果物。	アーティファクトインストールプロパティ[]
コンピュートVm	コンピューティング仮想マシンのプロパティ。	ComputeVmProperties の
createdByUser さん	仮想マシンの作成者の電子メール アドレス。	糸
createdByUserId (作成者によってユーザーID)	仮想マシンの作成者のオブジェクト識別子。	糸
作成日	仮想マシンの作成日。	糸
カスタムイメージID	仮想マシンのカスタム イメージ識別子。	糸
PublicIpAddress の許可しない	仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。	ブール (bool)
環境ID	この仮想マシンを含む環境のリソース ID (存在する場合)。	糸
有効期限	VM の有効期限。	糸
FQDNの	仮想マシンの完全修飾ドメイン名。	糸
galleryImageReference (英語)	仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。	ギャラリー画像参照
isAuthenticationWithSshKey (英語)	この仮想マシンが認証に SSH キーを使用するかどうかを示します。	ブール (bool)
labサブネット名	仮想マシンのラボ サブネット名。	糸
labVirtualNetworkId (英語)	仮想マシンのラボ仮想ネットワーク識別子。	糸
ネットワークインターフェース	ネットワーク インターフェイスのプロパティ。	ネットワークインターフェイスプロパティ
筆記	仮想マシンのメモ。	糸
osTypeの	仮想マシンの OS の種類。	糸
オーナーオブジェクトID	仮想マシンの所有者のオブジェクト識別子。	糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名)	仮想マシン所有者のユーザー プリンシパル名。	糸
パスワード	仮想マシン管理者のパスワード。	糸
プロビジョニング状態	リソースのプロビジョニング状態。	糸
大きさ	仮想マシンのサイズ。	糸
sshキー	仮想マシン管理者の SSH キー。	糸
ストレージタイプ	仮想マシンに使用するストレージの種類 (Standard、Premium など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
ユーザー名	仮想マシンのユーザー名。	糸
virtualMachineCreationSource	ラボ仮想マシンの作成元に指示します。 出力プロパティのみ。	「FromCustomImage」 「FromGalleryImage」

ネットワークインターフェイスプロパティ

名前	形容	価値
dnsName (英語)	DNS 名。	糸
プライベートIPアドレス	プライベート IP アドレス。	糸
パブリックIPアドレス	パブリック IP アドレス。	糸
publicIpAddressId (パブリック・イプアドレス・イド)	パブリック IP アドレスのリソース ID。	糸
rdpオーソリティ	RdpAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に RDP (リモート デスクトップ プロトコル) のサービス ポート番号が続くものです。	糸
sharedPublicIpAddressConfiguration	複数の仮想マシン間でパブリック IP アドレスを共有するための構成。	SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)
sshAuthority(英語)	SshAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に SSH のサービス ポート番号が続くものです。	糸
サブネットID	サブネットのリソース ID。	糸
virtualNetworkId(バーチャルネットワークID)	仮想ネットワークのリソース ID。	糸

通知設定

名前	形容	価値
地位	このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。	「無効」 「有効」
時間(分単位)	通知が送信されるイベントの前の時間 (分)。	整数 (int)
ウェブフックURL	通知の送信先となる Webhook URL。	糸

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

計画

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

スケジュールプロパティ

名前	形容	価値
毎日繰り返し	スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。	曜日詳細
毎時繰り返し	スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。	時間詳細
notificationSettings (通知設定)	通知の設定。	通知設定
プロビジョニング状態	リソースのプロビジョニング状態。	糸
地位	スケジュールの状態 (有効、無効)	「無効」 「有効」
ターゲットリソースID	スケジュールが属するリソース ID	糸
タスクタイプ	スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。	糸
タイムゾーンID	タイム ゾーン ID (太平洋標準時など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
weeklyRecurrence(週刊再発)	スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。	今週詳細

SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)

名前	形容	価値
inboundNatRules (英語)	受信 NAT 規則	InboundNatRule[]

今週詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸
平日	スケジュールが設定されている曜日 (日曜日、月曜日、火曜日など)。	文字列[]

使用例

Azure クイック スタートのサンプル

次 Azure クイック スタート テンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	形容
要求された VM を使用して Azure DevTest Labs にラボを作成します	このテンプレートは、要求された Windows Server 2019 Datacenter VM を含む新しい DevTest Lab/DTL インスタンスを作成します。 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates で利用可能な Azure DevTest Labs 用のその他の Azure Resource Manager クイック スタート テンプレート

ARM テンプレート リソース定義

ラボ/virtualmachines リソースの種類は、次をターゲットとする操作でデプロイできます。

• リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevTestLab/labs/virtualmachines リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2016-05-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        }
      },
      "tags": {
        "{customized property}": "string"
      }
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

名前	形容	価値
apiVersion (英語)	API のバージョン	'2016-05-15'
場所	リソースの場所。	糸
名前	リソース名	string (必須)
プロパティ	リソースのプロパティ。	LabVirtualMachineProperties (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。 テンプレート の タグを参照してください
種類	リソースの種類	'Microsoft.DevTestLab/labs/virtualmachines'

適用スケジュール

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ApplicableScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

ApplicableScheduleプロパティ

名前	形容	価値
labVmsシャットダウン	自動シャットダウン スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の
labVmsスタートアップ	自動起動スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の

アーティファクトデプロイメントステータスプロパティ

名前	形容	価値
アーティファクト適用済み	正常に適用された成果物の合計数。	整数 (int)
deploymentStatus(デプロイメントステータス)	成果物のデプロイ状態。	糸
totalArtifacts (合計アーティファクト)	仮適用された成果物の合計数。	整数 (int)

アーティファクトインストールプロパティ

名前	形容	価値
artifactId（アーティファクト識別子）	成果物の識別子。	糸
deploymentStatusMessage (デプロイメントステータスメッセージ)	デプロイからのステータス メッセージ。	糸
インストール時間	アーティファクトが仮想マシンへのインストールを開始する時間。	糸
パラメーター	成果物のパラメーター。	アーティファクトパラメータプロパティ[]
地位	成果物の状態。	糸
vmExtensionStatusMessage	仮想マシン拡張機能からのステータス メッセージ。	糸

アーティファクトパラメータプロパティ

名前	形容	価値
名前	アーティファクト パラメーターの名前。	糸
価値	アーティファクト パラメーターの値。	糸

コンピュートデータディスク

名前	形容	価値
ディスクサイズGiB	GiB 単位のデータ ディスク サイズを取得します。	整数 (int)
diskUri (英語)	BLOB によってバックアップされる場合、基になる BLOB の URI。	糸
managedDiskId の	マネージド ディスクによってバックアップされる場合、これはコンピューティング ディスク リソースの ID です。	糸
名前	データ ディスク名を取得します。	糸

ComputeVmInstanceViewステータス

名前	形容	価値
コード	状態コードを取得します。	糸
ディスプレイステータス	状態の短いローカライズ可能なラベルを取得します。	糸
メッセージ	状態に関連付けられているメッセージを取得します。	糸

ComputeVmProperties の

名前	形容	価値
データディスクID	仮想マシンのデータ ディスク BLOB URI を取得します。	文字列[]
データディスク	仮想マシンに接続されているすべてのデータ ディスクを取得します。	コンピュートデータディスク[]
ネットワークインターフェイスID	仮想マシンのネットワーク インターフェイス ID を取得します。	糸
osDiskId(英語)	仮想マシンの OS ディスク BLOB URI を取得します。	糸
osTypeの	仮想マシンの OS の種類を取得します。	糸
ステータス	仮想マシンの状態を取得します。	ComputeVmInstanceViewStatus[]
vmサイズ	仮想マシンのサイズを取得します。	糸

曜日詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸

ギャラリー画像参照

名前	形容	価値
提供	ギャラリー イメージのオファー。	糸
osTypeの	ギャラリー イメージの OS の種類。	糸
発行者	ギャラリー イメージの発行元。	糸
エスケーユー	ギャラリー イメージの SKU。	糸
バージョン	ギャラリー イメージのバージョン。	糸

時間詳細

名前	形容	価値
分	スケジュールが実行される時間の分数。	整数 (int)

InboundNatRule (英語)

名前	形容	価値
バックエンドポート	外部トラフィックがリダイレクトされるポート。	整数 (int)
フロントエンドポート	受信接続の外部エンドポイント ポート。 指定できる値の範囲は、1 ~ 65535 です。 指定しない場合、値は自動的に割り当てられます。	整数 (int)
トランスポートプロトコル	エンドポイントのトランスポート プロトコル。	'TCP' 「ウディプ」

LabVirtualMachineプロパティ

名前	形容	価値
allowClaim(許可要求)	別のユーザーが仮想マシンの所有権を取得できるかどうかを示します	ブール (bool)
該当スケジュール	仮想マシンに適用されるスケジュール。	適用スケジュール
アーティファクトデプロイメントステータス	仮想マシンの成果物のデプロイ状態。	アーティファクトデプロイメントステータスプロパティ
成果 物	仮想マシンにインストールする成果物。	アーティファクトインストールプロパティ[]
コンピュートVm	コンピューティング仮想マシンのプロパティ。	ComputeVmProperties の
createdByUser さん	仮想マシンの作成者の電子メール アドレス。	糸
createdByUserId (作成者によってユーザーID)	仮想マシンの作成者のオブジェクト識別子。	糸
作成日	仮想マシンの作成日。	糸
カスタムイメージID	仮想マシンのカスタム イメージ識別子。	糸
PublicIpAddress の許可しない	仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。	ブール (bool)
環境ID	この仮想マシンを含む環境のリソース ID (存在する場合)。	糸
有効期限	VM の有効期限。	糸
FQDNの	仮想マシンの完全修飾ドメイン名。	糸
galleryImageReference (英語)	仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。	ギャラリー画像参照
isAuthenticationWithSshKey (英語)	この仮想マシンが認証に SSH キーを使用するかどうかを示します。	ブール (bool)
labサブネット名	仮想マシンのラボ サブネット名。	糸
labVirtualNetworkId (英語)	仮想マシンのラボ仮想ネットワーク識別子。	糸
ネットワークインターフェース	ネットワーク インターフェイスのプロパティ。	ネットワークインターフェイスプロパティ
筆記	仮想マシンのメモ。	糸
osTypeの	仮想マシンの OS の種類。	糸
オーナーオブジェクトID	仮想マシンの所有者のオブジェクト識別子。	糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名)	仮想マシン所有者のユーザー プリンシパル名。	糸
パスワード	仮想マシン管理者のパスワード。	糸
プロビジョニング状態	リソースのプロビジョニング状態。	糸
大きさ	仮想マシンのサイズ。	糸
sshキー	仮想マシン管理者の SSH キー。	糸
ストレージタイプ	仮想マシンに使用するストレージの種類 (Standard、Premium など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
ユーザー名	仮想マシンのユーザー名。	糸
virtualMachineCreationSource	ラボ仮想マシンの作成元に指示します。 出力プロパティのみ。	「FromCustomImage」 「FromGalleryImage」

ネットワークインターフェイスプロパティ

名前	形容	価値
dnsName (英語)	DNS 名。	糸
プライベートIPアドレス	プライベート IP アドレス。	糸
パブリックIPアドレス	パブリック IP アドレス。	糸
publicIpAddressId (パブリック・イプアドレス・イド)	パブリック IP アドレスのリソース ID。	糸
rdpオーソリティ	RdpAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に RDP (リモート デスクトップ プロトコル) のサービス ポート番号が続くものです。	糸
sharedPublicIpAddressConfiguration	複数の仮想マシン間でパブリック IP アドレスを共有するための構成。	SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)
sshAuthority(英語)	SshAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に SSH のサービス ポート番号が続くものです。	糸
サブネットID	サブネットのリソース ID。	糸
virtualNetworkId(バーチャルネットワークID)	仮想ネットワークのリソース ID。	糸

通知設定

名前	形容	価値
地位	このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。	「無効」 「有効」
時間(分単位)	通知が送信されるイベントの前の時間 (分)。	整数 (int)
ウェブフックURL	通知の送信先となる Webhook URL。	糸

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

計画

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

スケジュールプロパティ

名前	形容	価値
毎日繰り返し	スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。	曜日詳細
毎時繰り返し	スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。	時間詳細
notificationSettings (通知設定)	通知の設定。	通知設定
プロビジョニング状態	リソースのプロビジョニング状態。	糸
地位	スケジュールの状態 (有効、無効)	「無効」 「有効」
ターゲットリソースID	スケジュールが属するリソース ID	糸
タスクタイプ	スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。	糸
タイムゾーンID	タイム ゾーン ID (太平洋標準時など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
weeklyRecurrence(週刊再発)	スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。	今週詳細

SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)

名前	形容	価値
inboundNatRules (英語)	受信 NAT 規則	InboundNatRule[]

今週詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸
平日	スケジュールが設定されている曜日 (日曜日、月曜日、火曜日など)。	文字列[]

使用例

Azure のクイック スタート テンプレート

このリソースの種類 デプロイする Azure クイック スタート テンプレート 次に示します。

テンプレート	形容
要求された VM を使用して Azure DevTest Labs にラボを作成します Azure にデプロイする	このテンプレートは、要求された Windows Server 2019 Datacenter VM を含む新しい DevTest Lab/DTL インスタンスを作成します。 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates で利用可能な Azure DevTest Labs 用のその他の Azure Resource Manager クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

ラボ/virtualmachines リソースの種類は、次をターゲットとする操作でデプロイできます。

• リソース グループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevTestLab/labs/virtualmachines リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
        }
        tags = {
          {customized property} = "string"
        }
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

名前	形容	価値
場所	リソースの場所。	糸
名前	リソース名	string (必須)
parent_id	このリソースの親であるリソースの ID。	種類のリソースの ID: ラボ
プロパティ	リソースのプロパティ。	LabVirtualMachineProperties (必須)
タグ	リソース タグ	タグ名と値のディクショナリ。
種類	リソースの種類	"Microsoft.DevTestLab/labs/virtualmachines@2016-05-15" (英語)

適用スケジュール

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ApplicableScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

ApplicableScheduleプロパティ

名前	形容	価値
labVmsシャットダウン	自動シャットダウン スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の
labVmsスタートアップ	自動起動スケジュール (ラボまたはラボ リソース レベルで設定されている場合)。	スケジュール の

アーティファクトデプロイメントステータスプロパティ

名前	形容	価値
アーティファクト適用済み	正常に適用された成果物の合計数。	整数 (int)
deploymentStatus(デプロイメントステータス)	成果物のデプロイ状態。	糸
totalArtifacts (合計アーティファクト)	仮適用された成果物の合計数。	整数 (int)

アーティファクトインストールプロパティ

名前	形容	価値
artifactId（アーティファクト識別子）	成果物の識別子。	糸
deploymentStatusMessage (デプロイメントステータスメッセージ)	デプロイからのステータス メッセージ。	糸
インストール時間	アーティファクトが仮想マシンへのインストールを開始する時間。	糸
パラメーター	成果物のパラメーター。	アーティファクトパラメータプロパティ[]
地位	成果物の状態。	糸
vmExtensionStatusMessage	仮想マシン拡張機能からのステータス メッセージ。	糸

アーティファクトパラメータプロパティ

名前	形容	価値
名前	アーティファクト パラメーターの名前。	糸
価値	アーティファクト パラメーターの値。	糸

コンピュートデータディスク

名前	形容	価値
ディスクサイズGiB	GiB 単位のデータ ディスク サイズを取得します。	整数 (int)
diskUri (英語)	BLOB によってバックアップされる場合、基になる BLOB の URI。	糸
managedDiskId の	マネージド ディスクによってバックアップされる場合、これはコンピューティング ディスク リソースの ID です。	糸
名前	データ ディスク名を取得します。	糸

ComputeVmInstanceViewステータス

名前	形容	価値
コード	状態コードを取得します。	糸
ディスプレイステータス	状態の短いローカライズ可能なラベルを取得します。	糸
メッセージ	状態に関連付けられているメッセージを取得します。	糸

ComputeVmProperties の

名前	形容	価値
データディスクID	仮想マシンのデータ ディスク BLOB URI を取得します。	文字列[]
データディスク	仮想マシンに接続されているすべてのデータ ディスクを取得します。	コンピュートデータディスク[]
ネットワークインターフェイスID	仮想マシンのネットワーク インターフェイス ID を取得します。	糸
osDiskId(英語)	仮想マシンの OS ディスク BLOB URI を取得します。	糸
osTypeの	仮想マシンの OS の種類を取得します。	糸
ステータス	仮想マシンの状態を取得します。	ComputeVmInstanceViewStatus[]
vmサイズ	仮想マシンのサイズを取得します。	糸

曜日詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸

ギャラリー画像参照

名前	形容	価値
提供	ギャラリー イメージのオファー。	糸
osTypeの	ギャラリー イメージの OS の種類。	糸
発行者	ギャラリー イメージの発行元。	糸
エスケーユー	ギャラリー イメージの SKU。	糸
バージョン	ギャラリー イメージのバージョン。	糸

時間詳細

名前	形容	価値
分	スケジュールが実行される時間の分数。	整数 (int)

InboundNatRule (英語)

名前	形容	価値
バックエンドポート	外部トラフィックがリダイレクトされるポート。	整数 (int)
フロントエンドポート	受信接続の外部エンドポイント ポート。 指定できる値の範囲は、1 ~ 65535 です。 指定しない場合、値は自動的に割り当てられます。	整数 (int)
トランスポートプロトコル	エンドポイントのトランスポート プロトコル。	'TCP' 「ウディプ」

LabVirtualMachineプロパティ

名前	形容	価値
allowClaim(許可要求)	別のユーザーが仮想マシンの所有権を取得できるかどうかを示します	ブール (bool)
該当スケジュール	仮想マシンに適用されるスケジュール。	適用スケジュール
アーティファクトデプロイメントステータス	仮想マシンの成果物のデプロイ状態。	アーティファクトデプロイメントステータスプロパティ
成果 物	仮想マシンにインストールする成果物。	アーティファクトインストールプロパティ[]
コンピュートVm	コンピューティング仮想マシンのプロパティ。	ComputeVmProperties の
createdByUser さん	仮想マシンの作成者の電子メール アドレス。	糸
createdByUserId (作成者によってユーザーID)	仮想マシンの作成者のオブジェクト識別子。	糸
作成日	仮想マシンの作成日。	糸
カスタムイメージID	仮想マシンのカスタム イメージ識別子。	糸
PublicIpAddress の許可しない	仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。	ブール (bool)
環境ID	この仮想マシンを含む環境のリソース ID (存在する場合)。	糸
有効期限	VM の有効期限。	糸
FQDNの	仮想マシンの完全修飾ドメイン名。	糸
galleryImageReference (英語)	仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。	ギャラリー画像参照
isAuthenticationWithSshKey (英語)	この仮想マシンが認証に SSH キーを使用するかどうかを示します。	ブール (bool)
labサブネット名	仮想マシンのラボ サブネット名。	糸
labVirtualNetworkId (英語)	仮想マシンのラボ仮想ネットワーク識別子。	糸
ネットワークインターフェース	ネットワーク インターフェイスのプロパティ。	ネットワークインターフェイスプロパティ
筆記	仮想マシンのメモ。	糸
osTypeの	仮想マシンの OS の種類。	糸
オーナーオブジェクトID	仮想マシンの所有者のオブジェクト識別子。	糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名)	仮想マシン所有者のユーザー プリンシパル名。	糸
パスワード	仮想マシン管理者のパスワード。	糸
プロビジョニング状態	リソースのプロビジョニング状態。	糸
大きさ	仮想マシンのサイズ。	糸
sshキー	仮想マシン管理者の SSH キー。	糸
ストレージタイプ	仮想マシンに使用するストレージの種類 (Standard、Premium など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
ユーザー名	仮想マシンのユーザー名。	糸
virtualMachineCreationSource	ラボ仮想マシンの作成元に指示します。 出力プロパティのみ。	「FromCustomImage」 「FromGalleryImage」

ネットワークインターフェイスプロパティ

名前	形容	価値
dnsName (英語)	DNS 名。	糸
プライベートIPアドレス	プライベート IP アドレス。	糸
パブリックIPアドレス	パブリック IP アドレス。	糸
publicIpAddressId (パブリック・イプアドレス・イド)	パブリック IP アドレスのリソース ID。	糸
rdpオーソリティ	RdpAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に RDP (リモート デスクトップ プロトコル) のサービス ポート番号が続くものです。	糸
sharedPublicIpAddressConfiguration	複数の仮想マシン間でパブリック IP アドレスを共有するための構成。	SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)
sshAuthority(英語)	SshAuthority プロパティは、サーバー DNS ホスト名または IP アドレスの後に SSH のサービス ポート番号が続くものです。	糸
サブネットID	サブネットのリソース ID。	糸
virtualNetworkId(バーチャルネットワークID)	仮想ネットワークのリソース ID。	糸

通知設定

名前	形容	価値
地位	このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。	「無効」 「有効」
時間(分単位)	通知が送信されるイベントの前の時間 (分)。	整数 (int)
ウェブフックURL	通知の送信先となる Webhook URL。	糸

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

リソースタグ

名前	形容	価値

計画

名前	形容	価値
場所	リソースの場所。	糸
プロパティ	リソースのプロパティ。	ScheduleProperties (必須)
タグ	リソースのタグ。	リソースタグ

スケジュールプロパティ

名前	形容	価値
毎日繰り返し	スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。	曜日詳細
毎時繰り返し	スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。	時間詳細
notificationSettings (通知設定)	通知の設定。	通知設定
プロビジョニング状態	リソースのプロビジョニング状態。	糸
地位	スケジュールの状態 (有効、無効)	「無効」 「有効」
ターゲットリソースID	スケジュールが属するリソース ID	糸
タスクタイプ	スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。	糸
タイムゾーンID	タイム ゾーン ID (太平洋標準時など)。	糸
ユニーク識別子	リソースの一意の変更できない識別子 (Guid)。	糸
weeklyRecurrence(週刊再発)	スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。	今週詳細

SharedPublicIpAddressConfiguration (共有パブリック・イプアドレス・コンフィギュレーション)

名前	形容	価値
inboundNatRules (英語)	受信 NAT 規則	InboundNatRule[]

今週詳細

名前	形容	価値
時間	スケジュールが発生する時刻。	糸
平日	スケジュールが設定されている曜日 (日曜日、月曜日、火曜日など)。	文字列[]