다음을 통해 공유

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • 아티클

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'
  }
}

속성 값

ApplicableSchedule

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ApplicableScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ApplicableScheduleProperties

이름 묘사 값
labVmsShutdown 랩 또는 랩 리소스 수준에서 설정된 경우 자동 종료 일정입니다. 일정
labVmsStartup 랩 또는 랩 리소스 수준에서 설정된 경우 자동 시작 일정입니다. 일정

ArtifactDeploymentStatusProperties

이름 묘사 값
artifactsApplied 성공적으로 적용된 아티팩트 총 개수입니다. int
deploymentStatus 아티팩트 배포 상태입니다. 문자열
totalArtifacts 미정으로 적용된 아티팩트 총 개수입니다. int

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

ComputeDataDisk

이름 묘사 값
diskSizeGiB GiB에서 데이터 디스크 크기를 가져옵니다. int
diskUri Blob에서 지원되는 경우 기본 Blob의 URI입니다. 문자열
managedDiskId 관리 디스크에서 지원되는 경우 컴퓨팅 디스크 리소스의 ID입니다. 문자열
이름 데이터 디스크 이름을 가져옵니다. 문자열

ComputeVmInstanceViewStatus

이름 묘사 값
코드 상태 코드를 가져옵니다. 문자열
displayStatus 상태에 대한 짧은 지역화 가능 레이블을 가져옵니다. 문자열
메시지 상태와 연결된 메시지를 가져옵니다. 문자열

ComputeVmProperties

이름 묘사 값
dataDiskIds 가상 머신에 대한 데이터 디스크 Blob URI를 가져옵니다. string[]
dataDisks 가상 머신에 연결된 모든 데이터 디스크를 가져옵니다. computeDataDisk[]
networkInterfaceId 가상 머신의 네트워크 인터페이스 ID를 가져옵니다. 문자열
osDiskId 가상 머신에 대한 OS 디스크 Blob URI를 가져옵니다. 문자열
osType 가상 머신의 OS 유형을 가져옵니다. 문자열
상태 가상 머신의 상태를 가져옵니다. computeVmInstanceViewStatus[]
vmSize 가상 머신의 크기를 가져옵니다. 문자열

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
applicableSchedule 가상 머신에 적용 가능한 일정입니다. ApplicableSchedule
artifactDeploymentStatus 가상 머신의 아티팩트 배포 상태입니다. ArtifactDeploymentStatusProperties
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
computeVm 컴퓨팅 가상 머신 속성입니다. ComputeVmProperties
createdByUser 가상 머신 작성자의 이메일 주소입니다. 문자열
createdByUserId 가상 머신 작성자의 개체 식별자입니다. 문자열
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
fqdn 가상 머신의 정규화된 도메인 이름입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
osType 가상 머신의 OS 유형입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열
provisioningState 리소스의 프로비전 상태입니다. 문자열
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열
virtualMachineCreationSource 랩 가상 머신 만들기의 원본을 알려줍니다. 출력 속성만 해당합니다. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
부모 Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다.

자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.		 형식 리소스의 기호 이름: 랩
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

일정

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ScheduleProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
provisioningState 리소스의 프로비전 상태입니다. 문자열
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 태평양 표준시)입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일 묘사
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다. 이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

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"
  }
}

속성 값

ApplicableSchedule

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ApplicableScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ApplicableScheduleProperties

이름 묘사 값
labVmsShutdown 랩 또는 랩 리소스 수준에서 설정된 경우 자동 종료 일정입니다. 일정
labVmsStartup 랩 또는 랩 리소스 수준에서 설정된 경우 자동 시작 일정입니다. 일정

ArtifactDeploymentStatusProperties

이름 묘사 값
artifactsApplied 성공적으로 적용된 아티팩트 총 개수입니다. int
deploymentStatus 아티팩트 배포 상태입니다. 문자열
totalArtifacts 미정으로 적용된 아티팩트 총 개수입니다. int

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

ComputeDataDisk

이름 묘사 값
diskSizeGiB GiB에서 데이터 디스크 크기를 가져옵니다. int
diskUri Blob에서 지원되는 경우 기본 Blob의 URI입니다. 문자열
managedDiskId 관리 디스크에서 지원되는 경우 컴퓨팅 디스크 리소스의 ID입니다. 문자열
이름 데이터 디스크 이름을 가져옵니다. 문자열

ComputeVmInstanceViewStatus

이름 묘사 값
코드 상태 코드를 가져옵니다. 문자열
displayStatus 상태에 대한 짧은 지역화 가능 레이블을 가져옵니다. 문자열
메시지 상태와 연결된 메시지를 가져옵니다. 문자열

ComputeVmProperties

이름 묘사 값
dataDiskIds 가상 머신에 대한 데이터 디스크 Blob URI를 가져옵니다. string[]
dataDisks 가상 머신에 연결된 모든 데이터 디스크를 가져옵니다. computeDataDisk[]
networkInterfaceId 가상 머신의 네트워크 인터페이스 ID를 가져옵니다. 문자열
osDiskId 가상 머신에 대한 OS 디스크 Blob URI를 가져옵니다. 문자열
osType 가상 머신의 OS 유형을 가져옵니다. 문자열
상태 가상 머신의 상태를 가져옵니다. computeVmInstanceViewStatus[]
vmSize 가상 머신의 크기를 가져옵니다. 문자열

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
applicableSchedule 가상 머신에 적용 가능한 일정입니다. ApplicableSchedule
artifactDeploymentStatus 가상 머신의 아티팩트 배포 상태입니다. ArtifactDeploymentStatusProperties
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
computeVm 컴퓨팅 가상 머신 속성입니다. ComputeVmProperties
createdByUser 가상 머신 작성자의 이메일 주소입니다. 문자열
createdByUserId 가상 머신 작성자의 개체 식별자입니다. 문자열
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
fqdn 가상 머신의 정규화된 도메인 이름입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
osType 가상 머신의 OS 유형입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열
provisioningState 리소스의 프로비전 상태입니다. 문자열
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열
virtualMachineCreationSource 랩 가상 머신 만들기의 원본을 알려줍니다. 출력 속성만 해당합니다. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
apiVersion api 버전 '2016-05-15'
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

일정

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ScheduleProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
provisioningState 리소스의 프로비전 상태입니다. 문자열
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 태평양 표준시)입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛 묘사
클레임된 VM 사용하여 Azure DevTest Labs에 랩을 만듭니다.

Azure 배포 		이 템플릿은 클레임된 Windows Server 2019 Datacenter VM을 사용하여 새 DevTest Lab/DTL 인스턴스를 만듭니다. Azure DevTest Labs용 Azure Resource Manager 빠른 시작 템플릿은 https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Terraform(AzAPI 공급자) 리소스 정의

랩/virtualmachines 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DevTestLab/labs/virtualmachines 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
    }
  })
}

속성 값

ApplicableSchedule

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ApplicableScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ApplicableScheduleProperties

이름 묘사 값
labVmsShutdown 랩 또는 랩 리소스 수준에서 설정된 경우 자동 종료 일정입니다. 일정
labVmsStartup 랩 또는 랩 리소스 수준에서 설정된 경우 자동 시작 일정입니다. 일정

ArtifactDeploymentStatusProperties

이름 묘사 값
artifactsApplied 성공적으로 적용된 아티팩트 총 개수입니다. int
deploymentStatus 아티팩트 배포 상태입니다. 문자열
totalArtifacts 미정으로 적용된 아티팩트 총 개수입니다. int

ArtifactInstallProperties

이름 묘사 값
artifactId 아티팩트의 식별자입니다. 문자열
deploymentStatusMessage 배포의 상태 메시지입니다. 문자열
installTime 아티팩트가 가상 머신에 설치하기 시작하는 시간입니다. 문자열
매개 변수 아티팩트 매개 변수입니다. ArtifactParameterProperties[]
상태 아티팩트 상태입니다. 문자열
vmExtensionStatusMessage 가상 머신 확장의 상태 메시지입니다. 문자열

ArtifactParameterProperties

이름 묘사 값
이름 아티팩트 매개 변수의 이름입니다. 문자열
값 아티팩트 매개 변수의 값입니다. 문자열

ComputeDataDisk

이름 묘사 값
diskSizeGiB GiB에서 데이터 디스크 크기를 가져옵니다. int
diskUri Blob에서 지원되는 경우 기본 Blob의 URI입니다. 문자열
managedDiskId 관리 디스크에서 지원되는 경우 컴퓨팅 디스크 리소스의 ID입니다. 문자열
이름 데이터 디스크 이름을 가져옵니다. 문자열

ComputeVmInstanceViewStatus

이름 묘사 값
코드 상태 코드를 가져옵니다. 문자열
displayStatus 상태에 대한 짧은 지역화 가능 레이블을 가져옵니다. 문자열
메시지 상태와 연결된 메시지를 가져옵니다. 문자열

ComputeVmProperties

이름 묘사 값
dataDiskIds 가상 머신에 대한 데이터 디스크 Blob URI를 가져옵니다. string[]
dataDisks 가상 머신에 연결된 모든 데이터 디스크를 가져옵니다. computeDataDisk[]
networkInterfaceId 가상 머신의 네트워크 인터페이스 ID를 가져옵니다. 문자열
osDiskId 가상 머신에 대한 OS 디스크 Blob URI를 가져옵니다. 문자열
osType 가상 머신의 OS 유형을 가져옵니다. 문자열
상태 가상 머신의 상태를 가져옵니다. computeVmInstanceViewStatus[]
vmSize 가상 머신의 크기를 가져옵니다. 문자열

DayDetails

이름 묘사 값
시간 일정이 수행되는 시간입니다. 문자열

GalleryImageReference

이름 묘사 값
제공 갤러리 이미지의 제안입니다. 문자열
osType 갤러리 이미지의 OS 유형입니다. 문자열
게시자 갤러리 이미지의 게시자입니다. 문자열
sku 갤러리 이미지의 SKU입니다. 문자열
버전 갤러리 이미지의 버전입니다. 문자열

HourDetails

이름 묘사 값
분 일정이 실행되는 시간(분)입니다. int

InboundNatRule

이름 묘사 값
backendPort 외부 트래픽을 리디렉션할 포트입니다. int
frontendPort 인바운드 연결의 외부 엔드포인트 포트입니다. 가능한 값 범위는 1에서 65535 사이입니다( 포함). 지정하지 않으면 값이 자동으로 할당됩니다. int
transportProtocol 엔드포인트에 대한 전송 프로토콜입니다. 'Tcp'
'Udp'

LabVirtualMachineProperties

이름 묘사 값
allowClaim 다른 사용자가 가상 머신의 소유권을 가져올 수 있는지 여부를 나타냅니다. bool
applicableSchedule 가상 머신에 적용 가능한 일정입니다. ApplicableSchedule
artifactDeploymentStatus 가상 머신의 아티팩트 배포 상태입니다. ArtifactDeploymentStatusProperties
아티팩트 가상 머신에 설치할 아티팩트입니다. ArtifactInstallProperties[]
computeVm 컴퓨팅 가상 머신 속성입니다. ComputeVmProperties
createdByUser 가상 머신 작성자의 이메일 주소입니다. 문자열
createdByUserId 가상 머신 작성자의 개체 식별자입니다. 문자열
createdDate 가상 머신의 생성 날짜입니다. 문자열
customImageId 가상 머신의 사용자 지정 이미지 식별자입니다. 문자열
disallowPublicIpAddress 공용 IP 주소 없이 가상 머신을 만들 것인지 여부를 나타냅니다. bool
environmentId 이 가상 머신이 포함된 환경의 리소스 ID(있는 경우)입니다. 문자열
expirationDate VM의 만료 날짜입니다. 문자열
fqdn 가상 머신의 정규화된 도메인 이름입니다. 문자열
galleryImageReference 가상 머신의 Microsoft Azure Marketplace 이미지 참조입니다. GalleryImageReference
isAuthenticationWithSshKey 이 가상 머신이 인증에 SSH 키를 사용하는지 여부를 나타냅니다. bool
labSubnetName 가상 머신의 랩 서브넷 이름입니다. 문자열
labVirtualNetworkId 가상 머신의 랩 가상 네트워크 식별자입니다. 문자열
networkInterface 네트워크 인터페이스 속성입니다. networkInterfaceProperties
노트 가상 머신의 메모입니다. 문자열
osType 가상 머신의 OS 유형입니다. 문자열
ownerObjectId 가상 머신 소유자의 개체 식별자입니다. 문자열
ownerUserPrincipalName 가상 머신 소유자의 사용자 계정 이름입니다. 문자열
암호 가상 머신 관리자의 암호입니다. 문자열
provisioningState 리소스의 프로비전 상태입니다. 문자열
크기 가상 머신의 크기입니다. 문자열
sshKey 가상 머신 관리자의 SSH 키입니다. 문자열
storageType 가상 머신(즉, 표준, 프리미엄)에 사용할 스토리지 유형입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
userName 가상 머신의 사용자 이름입니다. 문자열
virtualMachineCreationSource 랩 가상 머신 만들기의 원본을 알려줍니다. 출력 속성만 해당합니다. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

이름 묘사 값
위치 리소스의 위치입니다. 문자열
이름 리소스 이름 string(필수)
parent_id 이 리소스의 부모인 리소스의 ID입니다. 형식 리소스에 대한 ID: 랩
속성 리소스의 속성입니다. LabVirtualMachineProperties(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

이름 묘사 값
dnsName DNS 이름입니다. 문자열
privateIpAddress 개인 IP 주소입니다. 문자열
publicIpAddress 공용 IP 주소입니다. 문자열
publicIpAddressId 공용 IP 주소의 리소스 ID입니다. 문자열
rdpAuthority RdpAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 RDP(원격 데스크톱 프로토콜)에 대한 서비스 포트 번호입니다. 문자열
sharedPublicIpAddressConfiguration 여러 가상 머신에서 공용 IP 주소를 공유하기 위한 구성입니다. sharedPublicIpAddressConfiguration
sshAuthority SshAuthority 속성은 서버 DNS 호스트 이름 또는 IP 주소 뒤에 SSH에 대한 서비스 포트 번호입니다. 문자열
subnetId 서브넷의 리소스 ID입니다. 문자열
virtualNetworkId 가상 네트워크의 리소스 ID입니다. 문자열

NotificationSettings

이름 묘사 값
상태 이 일정에 대한 알림이 활성화된 경우(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
timeInMinutes 알림이 전송되는 이벤트 전 시간(분)입니다. int
webhookUrl 알림을 보낼 웹후크 URL입니다. 문자열

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

ResourceTags

이름 묘사 값

일정

이름 묘사 값
위치 리소스의 위치입니다. 문자열
속성 리소스의 속성입니다. ScheduleProperties(필수)
태그 리소스의 태그입니다. ResourceTags

ScheduleProperties

이름 묘사 값
dailyRecurrence 일정이 요일마다 한 번씩 발생하는 경우 일별 되풀이를 지정합니다. DayDetails
hourlyRecurrence 일정이 하루에 여러 번 발생하는 경우 시간별 되풀이를 지정합니다. HourDetails
notificationSettings 알림 설정입니다. notificationSettings
provisioningState 리소스의 프로비전 상태입니다. 문자열
상태 일정의 상태(예: 사용, 사용 안 함) '사용 안 함'
'Enabled'
targetResourceId 일정이 속한 리소스 ID 문자열
taskType 일정의 작업 유형(예: LabVmsShutdownTask, LabVmAutoStart)입니다. 문자열
timeZoneId 표준 시간대 ID(예: 태평양 표준시)입니다. 문자열
uniqueIdentifier 리소스의 변경할 수 없는 고유 식별자(Guid)입니다. 문자열
weeklyRecurrence 일정이 요일 중 일부만 발생하는 경우 매주 되풀이를 지정합니다. WeekDetails

SharedPublicIpAddressConfiguration

이름 묘사 값
inboundNatRules 들어오는 NAT 규칙 InboundNatRule[]

WeekDetails

이름 묘사 값
시간 일정이 수행되는 날짜의 시간입니다. 문자열
평일 일정이 설정된 요일(예: 일요일, 월요일, 화요일 등)입니다. string[]