다음을 통해 공유


New-AzureQuickVM

Azure 가상 머신을 구성하고 만듭니다.

참고

이 설명서에서 참조하는 cmdlet은 Service Management API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. Azure Resource Manager 리소스를 관리하는 cmdlet은 Az PowerShell 모듈을 참조하세요.

Syntax

New-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

New-AzureQuickVM cmdlet은 Azure 가상 머신을 구성하고 만듭니다. 이 cmdlet은 기존 Azure 서비스에 가상 머신을 배포할 수 있습니다. 이 cmdlet은 새 가상 머신을 호스트하는 Azure 서비스를 만들 수 있습니다.

예제

예제 1: 가상 머신 만들기

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

이 명령은 기존 서비스에서 Windows 운영 체제를 실행하는 가상 머신을 만듭니다. cmdlet은 지정된 이미지의 가상 머신을 기반으로 합니다. 이 명령은 WaitForBoot 매개 변수를 지정합니다. 따라서 cmdlet은 가상 머신이 시작될 때까지 기다립니다.

예제 2: 인증서를 사용하여 가상 머신 만들기

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

첫 번째 명령은 저장소에서 인증서를 가져오고 $certs 변수에 저장합니다.

두 번째 명령은 이미지에서 기존 서비스에서 Windows 운영 체제를 실행하는 가상 머신을 만듭니다. 기본적으로 WinRM Https 수신기는 가상 머신에서 사용하도록 설정됩니다. 이 명령은 WaitForBoot 매개 변수를 지정합니다. 따라서 cmdlet은 가상 머신이 시작될 때까지 기다립니다. 이 명령은 WinRM 인증서 및 X509Certificates를 호스트된 서비스에 업로드합니다.

예제 3: Linux 운영 체제를 실행하는 가상 머신 만들기

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

이 명령은 이미지에서 Linux 운영 체제를 실행하는 가상 머신을 만듭니다. 이 명령은 새 가상 머신을 호스트하는 서비스를 만듭니다. 이 명령은 서비스의 위치를 지정합니다.

예제 4: 가상 머신 만들기 및 새 가상 머신을 호스트하는 서비스 만들기

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

첫 번째 명령은 Get-AzureLocation cmdlet을 사용하여 위치를 가져오고 $Locations 배열 변수에 저장합니다.

두 번째 명령은 Get-AzureVMImage cmdlet을 사용하여 사용 가능한 이미지를 가져오고 $Images 배열 변수에 저장합니다.

최종 명령은 VirtualMachine25라는 대형 가상 머신을 만듭니다. 가상 머신은 Windows 운영 체제를 실행합니다. $Images 이미지 중 하나를 기반으로 합니다. 이 명령은 새 가상 머신에 대한 ContosoService03이라는 서비스를 만듭니다. 서비스는 $Locations 위치에 있습니다.

예제 5: 예약된 IP 이름을 가진 가상 머신 만들기

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

첫 번째 명령은 위치를 가져오고 $Locations 배열 변수에 저장합니다.

두 번째 명령은 사용 가능한 이미지를 가져오고 $Images 배열 변수에 저장합니다.

최종 명령은 $Images 이미지 중 하나를 기반으로 VirtualMachine27이라는 가상 머신을 만듭니다. 이 명령은 $Locations 위치에 서비스를 만듭니다. 가상 머신에는 이전에 $ipName 변수에 저장된 예약된 IP 이름이 있습니다.

매개 변수

-AdminUsername

이 cmdlet이 가상 머신에서 만드는 관리자 계정의 사용자 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AffinityGroup

가상 머신의 선호도 그룹을 지정합니다. 이 cmdlet이 가상 머신에 대한 Azure 서비스를 만드는 경우에만 이 매개 변수 또는 Location 매개 변수를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilitySetName

이 cmdlet이 가상 머신을 만드는 가용성 집합의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Certificates

이 cmdlet이 서비스를 만드는 데 사용하는 인증서 목록을 지정합니다.

Type:CertificateSettingList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomDataFile

가상 머신의 데이터 파일을 지정합니다. 이 cmdlet은 파일의 내용을 Base64로 인코딩합니다. 파일 길이는 64킬로바이트 미만이어야 합니다.

게스트 운영 체제가 Windows 운영 체제인 경우 이 cmdlet은 이 데이터를 %SYSTEMDRIVE%\AzureData\CustomData.bin이라는 이진 파일로 저장합니다.

게스트 운영 체제가 Linux인 경우 이 cmdlet은 ovf-env.xml 파일을 사용하여 데이터를 전달합니다. 설치는 해당 파일을 /var/lib/waagent 디렉터리에 복사합니다. 또한 에이전트는 Base64로 인코딩된 데이터를 /var/lib/waagent/CustomData에 저장합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableGuestAgent

이 cmdlet은 IaaS(Infrastructure as a Service) 프로비전 게스트 에이전트를 사용하지 않도록 설정합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWinRMHttps

이 cmdlet은 HTTPS에서 WinRM(Windows 원격 관리)을 사용하지 않도록 설정합니다. 기본적으로 WinRM은 HTTPS를 통해 사용하도록 설정됩니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsSettings

새 배포에 대한 DNS 설정을 정의하는 DNS 서버 개체의 배열을 지정합니다. DnsServer 개체를 만들려면 New-AzureDns cmdlet을 사용합니다.

Type:DnsServer[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableWinRMHttp

이 cmdlet이 HTTP를 통해 WinRM을 사용하도록 설정했음을 나타냅니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostCaching

운영 체제 디스크의 호스트 캐싱 모드를 지정합니다. 유효한 값은 다음과 같습니다.

  • 읽기 전용
  • ReadWrite
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageName

이 cmdlet이 운영 체제 디스크를 만드는 데 사용하는 디스크 이미지의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InformationAction

이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 계속
  • 무시
  • 문의
  • SilentlyContinue
  • Stop
  • 일시 중단
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

정보 변수를 지정합니다.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceSize

인스턴스의 크기를 지정합니다. 유효한 값은 다음과 같습니다.

  • ExtraSmall
  • 중간
  • ExtraLarge
  • A5
  • A6
  • A7
  • A8
  • A9
  • Basic_A0
  • Basic_A1
  • Basic_A2
  • Basic_A3
  • Basic_A4
  • Standard_D1
  • Standard_D2
  • Standard_D3
  • Standard_D4
  • Standard_D11
  • Standard_D12
  • Standard_D13
  • Standard_D14
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

이 cmdlet은 Linux 기반 가상 머신을 만듭니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LinuxUser

이 cmdlet이 가상 머신에서 만드는 Linux 관리 계정의 사용자 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

가상 머신을 호스트하는 Azure 데이터 센터를 지정합니다. 이 매개 변수를 지정하면 cmdlet은 지정된 위치에 Azure 서비스를 만듭니다. 이 cmdlet이 가상 머신에 대한 Azure 서비스를 만드는 경우에만 이 매개 변수 또는 AffinityGroup 매개 변수를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MediaLocation

이 cmdlet이 가상 머신 디스크를 만드는 Azure Storage 위치를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

이 cmdlet이 만드는 가상 머신의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoExportPrivateKey

이 구성이 프라이빗 키를 업로드하지 않음을 나타냅니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWinRMEndpoint

이 cmdlet은 가상 머신에 대한 WinRM 엔드포인트를 추가하지 않음을 나타냅니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

관리 계정의 암호를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReservedIPName

예약된 IP 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReverseDnsFqdn

역방향 DNS 조회에 대한 정규화된 도메인 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

이 cmdlet이 새 가상 머신을 추가하는 새 또는 기존 Azure 서비스의 이름을 지정합니다.

새 서비스를 지정하는 경우 이 cmdlet은 새 서비스를 만듭니다. 새 서비스를 만들려면 Location 또는 AffinityGroup 매개 변수를 지정해야 합니다.

기존 서비스를 지정하는 경우 위치 또는 선호도 그룹을 지정하지 마세요.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SSHKeyPairs

SSH 키 쌍을 지정합니다.

Type:SSHKeyPairList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSHPublicKeys

SSH 공개 키를 지정합니다.

Type:SSHPublicKeyList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetNames

가상 머신의 서브넷 이름 배열을 지정합니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VNetName

가상 머신에 대한 가상 네트워크의 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForBoot

이 cmdlet은 가상 머신이 ReadyRole 상태에 도달할 때까지 대기한다는 것을 나타냅니다. 가상 머신이 다음 상태 중 하나에 도달하면 cmdlet이 실패합니다. FailedStartingVM, ProvisioningFailed 또는 ProvisioningTimeout입니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Windows

이 cmdlet은 Windows 가상 머신을 만듭니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WinRMCertificate

이 cmdlet이 WinRM 엔드포인트에 연결하는 인증서를 지정합니다.

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-X509Certificates

호스트된 서비스에 배포되는 X509 인증서의 배열을 지정합니다.

Type:X509Certificate2[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False