New-AzureQuickVM

참조

모듈:: Azure

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

참고 항목

이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.

Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.

구문

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이 가상 머신에서 만드는 관리자 계정의 사용자 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AffinityGroup

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AvailabilitySetName

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Certificates

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

형식:	CertificateSettingList
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CustomDataFile

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

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

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableGuestAgent

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableWinRMHttps

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DnsSettings

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

형식:	DnsServer[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableWinRMHttp

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HostCaching

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

읽기 전용
ReadWrite

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageName

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

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InformationAction

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

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

계속
무시
묻다
SilentlyContinue
중지
일시 중단됨

형식:	ActionPreference
별칭:	infa
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InformationVariable

정보 변수를 지정합니다.

형식:	String
별칭:	iv
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InstanceSize

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

매우 작음
소
중간
대
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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Linux

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-LinuxUser

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Location

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MediaLocation

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoExportPrivateKey

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoWinRMEndpoint

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Password

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Profile

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

형식:	AzureSMProfile
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ReservedIPName

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ReverseDnsFqdn

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-ServiceName

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

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

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

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SSHKeyPairs

SSH 키 쌍을 지정합니다.

형식:	SSHKeyPairList
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SSHPublicKeys

SSH 공개 키를 지정합니다.

형식:	SSHPublicKeyList
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SubnetNames

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

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VNetName

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WaitForBoot

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Windows

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WinRMCertificate

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

형식:	X509Certificate2
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-X509Certificates

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

형식:	X509Certificate2[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

다음을 통해 공유