次の方法で共有

Microsoft.DevTestLab ラボ/virtualmachines 2018-09-15

Bicep リソース定義

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

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

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

リソースの形式

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

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    artifacts: [
      {
        artifactId: 'string'
        artifactTitle: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    createdDate: 'string'
    customImageId: 'string'
    dataDiskParameters: [
      {
        attachNewDataDiskOptions: {
          diskName: 'string'
          diskSizeGiB: int
          diskType: 'string'
        }
        existingLabDiskId: 'string'
        hostCaching: 'string'
      }
    ]
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: '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'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    planId: 'string'
    scheduleParameters: [
      {
        name: 'string'
        properties: {
          dailyRecurrence: {
            time: 'string'
          }
          hourlyRecurrence: {
            minute: int
          }
          notificationSettings: {
            emailRecipient: 'string'
            notificationLocale: 'string'
            status: 'string'
            timeInMinutes: int
            webhookUrl: 'string'
          }
          status: 'string'
          targetResourceId: 'string'
          taskType: 'string'
          timeZoneId: 'string'
          weeklyRecurrence: {
            time: 'string'
            weekdays: [
              'string'
            ]
          }
        }
        tags: {
          {customized property}: 'string'
        }
      }
    ]
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    userName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

名前 形容 価値
場所 リソースの場所。 糸
名前 リソース名 string (必須)
親 Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。		 種類のリソースのシンボリック名: ラボ
プロパティ リソースのプロパティ。 LabVirtualMachineProperties (必須)
タグ リソース タグ タグ名と値のディクショナリ。 テンプレート の タグを参照してください

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

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

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

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

AttachNewDataDiskオプション

名前 形容 価値
ディスク名 接続するディスクの名前。 糸
ディスクサイズGiB 接続するディスクのサイズ (ギビバイト単位)。 整数 (int)
ディスクタイプ ディスクのストレージの種類 (Standard、Premium など)。 「プレミアム」
「スタンダード」
「スタンダードSSD」

DataDiskProperties (英語)

名前 形容 価値
attachNewDataDiskOptions (新しいデータディスクのオプションをアタッチする) 新しいディスクを仮想マシンに接続するためのオプションを指定します。 AttachNewDataDiskOptions の
existingLabDiskId(既存のLabDiskId) 仮想マシンにアタッチする既存のラボ ディスク ID を指定します。 糸
ホストキャッシング データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。 「なし」
「読み取り専用」
'ReadWrite' (読み取り書き込み)

曜日詳細

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

ギャラリー画像参照

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

時間詳細

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

InboundNatRule (英語)

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

LabVirtualMachineプロパティ

名前 形容 価値
allowClaim(許可要求) 別のユーザーが仮想マシンの所有権を取得できるかどうかを示します ブール (bool)
成果 物 仮想マシンにインストールする成果物。 アーティファクトインストールプロパティ[]
作成日 仮想マシンの作成日。 糸
カスタムイメージID 仮想マシンのカスタム イメージ識別子。 糸
dataDiskParameters 作成後に仮想マシンに接続する新規または既存のデータ ディスク DataDiskProperties[]
PublicIpAddress の許可しない 仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。 ブール (bool)
環境ID この仮想マシンを含む環境のリソース ID (存在する場合)。 糸
有効期限 VM の有効期限。 糸
galleryImageReference (英語) 仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。 ギャラリー画像参照
isAuthenticationWithSshKey (英語) この仮想マシンが認証に SSH キーを使用するかどうかを示します。 ブール (bool)
labサブネット名 仮想マシンのラボ サブネット名。 糸
labVirtualNetworkId (英語) 仮想マシンのラボ仮想ネットワーク識別子。 糸
ネットワークインターフェース ネットワーク インターフェイスのプロパティ。 ネットワークインターフェイスプロパティ
筆記 仮想マシンのメモ。 糸
オーナーオブジェクトID 仮想マシンの所有者のオブジェクト識別子。 糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名) 仮想マシン所有者のユーザー プリンシパル名。 糸
パスワード 仮想マシン管理者のパスワード。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
planId(プランイド) 仮想マシン イメージに関連付けられているプランの ID 糸
scheduleParameters (スケジュールパラメータ) 作成する仮想マシンのスケジュール ScheduleCreationParameter[]
大きさ 仮想マシンのサイズ。 糸
sshキー 仮想マシン管理者の SSH キー。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
ストレージタイプ 仮想マシンに使用するストレージの種類 (Standard、Premium など)。 糸
ユーザー名 仮想マシンのユーザー名。 糸

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

名前 形容 価値
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。 糸

通知設定

名前 形容 価値
メール受信者 通知を送信する電子メール受信者 (セミコロンで区切られた電子メール アドレスの一覧を指定できます)。 糸
notificationLocale 通知を送信するときに使用するロケール (サポートされていない言語のフォールバックは EN です)。 糸
地位 このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。 「無効」
「有効」
時間(分単位) 通知が送信されるイベントの前の時間 (分)。 整数 (int)
ウェブフックURL 通知の送信先となる Webhook URL。 糸

リソースタグ

名前 形容 価値

スケジュール作成パラメータ

名前 形容 価値
名前 仮想マシンまたは環境の名前 糸
プロパティ スケジュールのプロパティ。 ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)
タグ リソースのタグ。 ScheduleCreationParameterタグ

ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)

名前 形容 価値
毎日繰り返し スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。 曜日詳細
毎時繰り返し スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。 時間詳細
notificationSettings (通知設定) 通知の設定。 通知設定
地位 スケジュールの状態 (有効、無効) 「無効」
「有効」
ターゲットリソースID スケジュールが属するリソース ID 糸
タスクタイプ スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。 糸
タイムゾーンID タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティに指定できる値は、IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にあります。 糸
weeklyRecurrence(週刊再発) スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。 今週詳細

ScheduleCreationParameterタグ

名前 形容 価値

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": "2018-09-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "artifacts": [
      {
        "artifactId": "string",
        "artifactTitle": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "createdDate": "string",
    "customImageId": "string",
    "dataDiskParameters": [
      {
        "attachNewDataDiskOptions": {
          "diskName": "string",
          "diskSizeGiB": "int",
          "diskType": "string"
        },
        "existingLabDiskId": "string",
        "hostCaching": "string"
      }
    ],
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "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",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "planId": "string",
    "scheduleParameters": [
      {
        "name": "string",
        "properties": {
          "dailyRecurrence": {
            "time": "string"
          },
          "hourlyRecurrence": {
            "minute": "int"
          },
          "notificationSettings": {
            "emailRecipient": "string",
            "notificationLocale": "string",
            "status": "string",
            "timeInMinutes": "int",
            "webhookUrl": "string"
          },
          "status": "string",
          "targetResourceId": "string",
          "taskType": "string",
          "timeZoneId": "string",
          "weeklyRecurrence": {
            "time": "string",
            "weekdays": [ "string" ]
          }
        },
        "tags": {
          "{customized property}": "string"
        }
      }
    ],
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "userName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

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

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

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

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

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

AttachNewDataDiskオプション

名前 形容 価値
ディスク名 接続するディスクの名前。 糸
ディスクサイズGiB 接続するディスクのサイズ (ギビバイト単位)。 整数 (int)
ディスクタイプ ディスクのストレージの種類 (Standard、Premium など)。 「プレミアム」
「スタンダード」
「スタンダードSSD」

DataDiskProperties (英語)

名前 形容 価値
attachNewDataDiskOptions (新しいデータディスクのオプションをアタッチする) 新しいディスクを仮想マシンに接続するためのオプションを指定します。 AttachNewDataDiskOptions の
existingLabDiskId(既存のLabDiskId) 仮想マシンにアタッチする既存のラボ ディスク ID を指定します。 糸
ホストキャッシング データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。 「なし」
「読み取り専用」
'ReadWrite' (読み取り書き込み)

曜日詳細

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

ギャラリー画像参照

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

時間詳細

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

InboundNatRule (英語)

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

LabVirtualMachineプロパティ

名前 形容 価値
allowClaim(許可要求) 別のユーザーが仮想マシンの所有権を取得できるかどうかを示します ブール (bool)
成果 物 仮想マシンにインストールする成果物。 アーティファクトインストールプロパティ[]
作成日 仮想マシンの作成日。 糸
カスタムイメージID 仮想マシンのカスタム イメージ識別子。 糸
dataDiskParameters 作成後に仮想マシンに接続する新規または既存のデータ ディスク DataDiskProperties[]
PublicIpAddress の許可しない 仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。 ブール (bool)
環境ID この仮想マシンを含む環境のリソース ID (存在する場合)。 糸
有効期限 VM の有効期限。 糸
galleryImageReference (英語) 仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。 ギャラリー画像参照
isAuthenticationWithSshKey (英語) この仮想マシンが認証に SSH キーを使用するかどうかを示します。 ブール (bool)
labサブネット名 仮想マシンのラボ サブネット名。 糸
labVirtualNetworkId (英語) 仮想マシンのラボ仮想ネットワーク識別子。 糸
ネットワークインターフェース ネットワーク インターフェイスのプロパティ。 ネットワークインターフェイスプロパティ
筆記 仮想マシンのメモ。 糸
オーナーオブジェクトID 仮想マシンの所有者のオブジェクト識別子。 糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名) 仮想マシン所有者のユーザー プリンシパル名。 糸
パスワード 仮想マシン管理者のパスワード。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
planId(プランイド) 仮想マシン イメージに関連付けられているプランの ID 糸
scheduleParameters (スケジュールパラメータ) 作成する仮想マシンのスケジュール ScheduleCreationParameter[]
大きさ 仮想マシンのサイズ。 糸
sshキー 仮想マシン管理者の SSH キー。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
ストレージタイプ 仮想マシンに使用するストレージの種類 (Standard、Premium など)。 糸
ユーザー名 仮想マシンのユーザー名。 糸

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

名前 形容 価値
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。 糸

通知設定

名前 形容 価値
メール受信者 通知を送信する電子メール受信者 (セミコロンで区切られた電子メール アドレスの一覧を指定できます)。 糸
notificationLocale 通知を送信するときに使用するロケール (サポートされていない言語のフォールバックは EN です)。 糸
地位 このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。 「無効」
「有効」
時間(分単位) 通知が送信されるイベントの前の時間 (分)。 整数 (int)
ウェブフックURL 通知の送信先となる Webhook URL。 糸

リソースタグ

名前 形容 価値

スケジュール作成パラメータ

名前 形容 価値
名前 仮想マシンまたは環境の名前 糸
プロパティ スケジュールのプロパティ。 ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)
タグ リソースのタグ。 ScheduleCreationParameterタグ

ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)

名前 形容 価値
毎日繰り返し スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。 曜日詳細
毎時繰り返し スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。 時間詳細
notificationSettings (通知設定) 通知の設定。 通知設定
地位 スケジュールの状態 (有効、無効) 「無効」
「有効」
ターゲットリソースID スケジュールが属するリソース ID 糸
タスクタイプ スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。 糸
タイムゾーンID タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティに指定できる値は、IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にあります。 糸
weeklyRecurrence(週刊再発) スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。 今週詳細

ScheduleCreationParameterタグ

名前 形容 価値

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@2018-09-15"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowClaim = bool
      artifacts = [
        {
          artifactId = "string"
          artifactTitle = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      createdDate = "string"
      customImageId = "string"
      dataDiskParameters = [
        {
          attachNewDataDiskOptions = {
            diskName = "string"
            diskSizeGiB = int
            diskType = "string"
          }
          existingLabDiskId = "string"
          hostCaching = "string"
        }
      ]
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "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"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      planId = "string"
      scheduleParameters = [
        {
          name = "string"
          properties = {
            dailyRecurrence = {
              time = "string"
            }
            hourlyRecurrence = {
              minute = int
            }
            notificationSettings = {
              emailRecipient = "string"
              notificationLocale = "string"
              status = "string"
              timeInMinutes = int
              webhookUrl = "string"
            }
            status = "string"
            targetResourceId = "string"
            taskType = "string"
            timeZoneId = "string"
            weeklyRecurrence = {
              time = "string"
              weekdays = [
                "string"
              ]
            }
          }
          tags = {
            {customized property} = "string"
          }
        }
      ]
      size = "string"
      sshKey = "string"
      storageType = "string"
      userName = "string"
    }
  }
}

プロパティ値

Microsoft.DevTestLab/labs/virtualmachines

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

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

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

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

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

AttachNewDataDiskオプション

名前 形容 価値
ディスク名 接続するディスクの名前。 糸
ディスクサイズGiB 接続するディスクのサイズ (ギビバイト単位)。 整数 (int)
ディスクタイプ ディスクのストレージの種類 (Standard、Premium など)。 「プレミアム」
「スタンダード」
「スタンダードSSD」

DataDiskProperties (英語)

名前 形容 価値
attachNewDataDiskOptions (新しいデータディスクのオプションをアタッチする) 新しいディスクを仮想マシンに接続するためのオプションを指定します。 AttachNewDataDiskOptions の
existingLabDiskId(既存のLabDiskId) 仮想マシンにアタッチする既存のラボ ディスク ID を指定します。 糸
ホストキャッシング データ ディスクのキャッシュ オプション (None、ReadOnly、ReadWrite など)。 「なし」
「読み取り専用」
'ReadWrite' (読み取り書き込み)

曜日詳細

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

ギャラリー画像参照

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

時間詳細

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

InboundNatRule (英語)

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

LabVirtualMachineプロパティ

名前 形容 価値
allowClaim(許可要求) 別のユーザーが仮想マシンの所有権を取得できるかどうかを示します ブール (bool)
成果 物 仮想マシンにインストールする成果物。 アーティファクトインストールプロパティ[]
作成日 仮想マシンの作成日。 糸
カスタムイメージID 仮想マシンのカスタム イメージ識別子。 糸
dataDiskParameters 作成後に仮想マシンに接続する新規または既存のデータ ディスク DataDiskProperties[]
PublicIpAddress の許可しない 仮想マシンをパブリック IP アドレスなしで作成するかどうかを示します。 ブール (bool)
環境ID この仮想マシンを含む環境のリソース ID (存在する場合)。 糸
有効期限 VM の有効期限。 糸
galleryImageReference (英語) 仮想マシンの Microsoft Azure Marketplace イメージ リファレンス。 ギャラリー画像参照
isAuthenticationWithSshKey (英語) この仮想マシンが認証に SSH キーを使用するかどうかを示します。 ブール (bool)
labサブネット名 仮想マシンのラボ サブネット名。 糸
labVirtualNetworkId (英語) 仮想マシンのラボ仮想ネットワーク識別子。 糸
ネットワークインターフェース ネットワーク インターフェイスのプロパティ。 ネットワークインターフェイスプロパティ
筆記 仮想マシンのメモ。 糸
オーナーオブジェクトID 仮想マシンの所有者のオブジェクト識別子。 糸
ownerUserPrincipalName (オーナー ユーザープリンシパル名) 仮想マシン所有者のユーザー プリンシパル名。 糸
パスワード 仮想マシン管理者のパスワード。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
planId(プランイド) 仮想マシン イメージに関連付けられているプランの ID 糸
scheduleParameters (スケジュールパラメータ) 作成する仮想マシンのスケジュール ScheduleCreationParameter[]
大きさ 仮想マシンのサイズ。 糸
sshキー 仮想マシン管理者の SSH キー。 糸

制約：
機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。
ストレージタイプ 仮想マシンに使用するストレージの種類 (Standard、Premium など)。 糸
ユーザー名 仮想マシンのユーザー名。 糸

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

名前 形容 価値
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。 糸

通知設定

名前 形容 価値
メール受信者 通知を送信する電子メール受信者 (セミコロンで区切られた電子メール アドレスの一覧を指定できます)。 糸
notificationLocale 通知を送信するときに使用するロケール (サポートされていない言語のフォールバックは EN です)。 糸
地位 このスケジュールに対して通知が有効になっている場合 (つまり、有効、無効)。 「無効」
「有効」
時間(分単位) 通知が送信されるイベントの前の時間 (分)。 整数 (int)
ウェブフックURL 通知の送信先となる Webhook URL。 糸

リソースタグ

名前 形容 価値

スケジュール作成パラメータ

名前 形容 価値
名前 仮想マシンまたは環境の名前 糸
プロパティ スケジュールのプロパティ。 ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)
タグ リソースのタグ。 ScheduleCreationParameterタグ

ScheduleCreationParameterProperties (スケジュール作成パラメータプロパティ)

名前 形容 価値
毎日繰り返し スケジュールが週の各日に 1 回行われる場合は、毎日の繰り返しを指定します。 曜日詳細
毎時繰り返し スケジュールが 1 日に複数回発生する場合は、1 時間ごとに繰り返しを指定します。 時間詳細
notificationSettings (通知設定) 通知の設定。 通知設定
地位 スケジュールの状態 (有効、無効) 「無効」
「有効」
ターゲットリソースID スケジュールが属するリソース ID 糸
タスクタイプ スケジュールのタスクの種類 (LabVmsShutdownTask、LabVmAutoStart など)。 糸
タイムゾーンID タイム ゾーン ID (中国標準時、グリーンランド標準時、太平洋標準時など)。 このプロパティに指定できる値は、IReadOnlyCollection<string> TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md) にあります。 糸
weeklyRecurrence(週刊再発) スケジュールが週の数日だけ発生する場合は、週単位の繰り返しを指定します。 今週詳細

ScheduleCreationParameterタグ

名前 形容 価値

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

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

今週詳細

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