New-AzNetworkCloudVirtualMachine

참조

모듈:: Az.NetworkCloud

새 가상 머신을 만들거나 기존 가상 머신의 속성을 업데이트합니다.

구문

New-AzNetworkCloudVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -AdminUsername <String>
   -CloudServiceNetworkAttachmentAttachedNetworkId <String>
   -CloudServiceNetworkAttachmentIPAllocationMethod <VirtualMachineIPAllocationMethod>
   -CpuCore <Int64>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -Location <String>
   -MemorySizeGb <Int64>
   -OSDiskSizeGb <Int64>
   -VMImage <String>
   [-BootMethod <VirtualMachineBootMethod>]
   [-CloudServiceNetworkAttachmentDefaultGateway <DefaultGateway>]
   [-CloudServiceNetworkAttachmentIpv4Address <String>]
   [-CloudServiceNetworkAttachmentIpv6Address <String>]
   [-CloudServiceNetworkAttachmentName <String>]
   [-IsolateEmulatorThread <VirtualMachineIsolateEmulatorThread>]
   [-NetworkAttachment <INetworkAttachment[]>]
   [-NetworkData <String>]
   [-OSDiskCreateOption <OSDiskCreateOption>]
   [-OSDiskDeleteOption <OSDiskDeleteOption>]
   [-PlacementHint <IVirtualMachinePlacementHint[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-StorageProfileVolumeAttachment <String[]>]
   [-Tag <Hashtable>]
   [-UserData <String>]
   [-VMDeviceModel <VirtualMachineDeviceModelType>]
   [-VMImageRepositoryCredentialsPassword <SecureString>]
   [-VMImageRepositoryCredentialsRegistryUrl <String>]
   [-VMImageRepositoryCredentialsUsername <String>]
   [-VirtioInterface <VirtualMachineVirtioInterfaceType>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

새 가상 머신을 만들거나 기존 가상 머신의 속성을 업데이트합니다.

예제

예제 1: 가상 머신 만들기

$networkAttachment = @{
    AttachedNetworkId = "attachedNetworkID"
    IpAllocationMethod = "Dynamic"
}
$hint = @{
    HintType = "Affinity"
    SchedulingExecution = "schedulingExecution"
    Scope = "scope"
    ResourceId = "resourceId"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}

$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudVirtualMachine -Name vmName  -ResourceGroupName resourceGroup -AdminUsername adminUsername -CloudServiceNetworkAttachmentAttachedNetworkId csnAttachedNetworkId -CloudServiceNetworkAttachmentIPAllocationMethod ipAllocationMethod -CpuCore cpuCore -ExtendedLocationName extendedLocationName -ExtendedLocationType "Custom" -Location location -SubscriptionId subscriptionId -MemorySizeGb memorySizeGb -OSDiskSizeGb osDiskSizeGb -VMImage vmImage -BootMethod bootMethod -CloudServiceNetworkAttachmentDefaultGateway defaultGateway -CloudServiceNetworkAttachmentName csnAttachmentName -IsolateEmulatorThread isolateEmulatorThread -NetworkAttachment $networkAttachment -NetworkData networkData -OSDiskCreateOption osDiskCreationOption -OSDiskDeleteOption osDiskDeleteOption -PlacementHint $hint -SshPublicKey $sshPublicKey -Tag @{tags = "tags"} -UserData userData -VirtioInterface virtioInterface -VMDeviceModel vmDeviceModel -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $securePassword -VMImageRepositoryCredentialsRegistryUrl registryUrl

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataL
                                                                                                                                                  astModified
                                                                                                                                                  ByType
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             -----------
eastus   default 7/07/2023 21:32:03 <user>                 User                    07/07/2023 21:32:41      <identity>                           Application

이 명령은 가상 머신을 만듭니다.

매개 변수

-AdminUsername

ssh 공개 키가 권한 있는 키에 추가될 관리자의 이름입니다.

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

-AsJob

작업으로 명령 실행

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

-BootMethod

가상 머신에 대한 부팅 방법을 선택합니다.

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

-CloudServiceNetworkAttachmentAttachedNetworkId

가상 머신에 연결된 연결된 네트워크의 리소스 ID입니다. cloudServicesNetwork, l3Network, l2Network 또는 트렁크넷워크 리소스 중 하나일 수 있습니다.

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

-CloudServiceNetworkAttachmentDefaultGateway

이것이 기본 게이트웨이인지 여부를 나타내는 표시기입니다. 단일 컴퓨터에 대한 연결된 네트워크(CloudServicesNetwork 첨부 파일 포함) 중 하나만 True로 지정할 수 있습니다.

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

-CloudServiceNetworkAttachmentIPAllocationMethod

가상 머신에 대한 IP 할당 메커니즘입니다. 동적 및 정적은 Disabled를 지정할 수도 있는 l3Network에만 유효합니다. 그렇지 않으면 사용 안 함 값만 허용됩니다.

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

-CloudServiceNetworkAttachmentIpv4Address

가상 머신의 IPv4 주소입니다. 이 필드는 연결된 네트워크에 IPV4 또는 DualStack의 IPAllocationType이 있는 경우에만 사용됩니다. IPAllocationMethod가:Static인 경우 이 필드는 연결된 네트워크에 지정된 서브넷 내에서 사용자가 지정한 IPv4 주소를 포함해야 합니다. 동적 - 이 필드는 읽기 전용이지만 연결된 네트워크에 지정된 서브넷 내에서 주소로 채워집니다. 사용 안 함 - 이 필드는 비어 있습니다.

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

-CloudServiceNetworkAttachmentIpv6Address

가상 머신의 IPv6 주소입니다. 이 필드는 연결된 네트워크에 IPV6 또는 DualStack의 IPAllocationType이 있는 경우에만 사용됩니다.IPAllocationMethod가:Static인 경우 이 필드는 연결된 네트워크에 지정된 범위 내에서 IPv6 주소 범위를 포함해야 합니다. 동적 - 이 필드는 읽기 전용이지만 연결된 네트워크에 지정된 서브넷 내의 범위로 채워집니다. 사용 안 함 - 이 필드는 비어 있습니다.

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

-CloudServiceNetworkAttachmentName

연결된 네트워크의 인터페이스 이름입니다. 지정한 경우 네트워크 첨부 파일 이름은 최대 길이가 15자이며 이 가상 머신에 고유해야 합니다. 사용자가 이 값을 지정하지 않으면 네트워크 리소스의 기본 인터페이스 이름이 사용됩니다. CloudServicesNetwork 리소스의 경우 이 이름은 무시됩니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-CpuCore

가상 머신의 CPU 코어 수입니다.

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

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

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

-ExtendedLocationName

리소스를 만들 확장 위치의 리소스 ID입니다.

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

-ExtendedLocationType

확장된 위치 유형(예: CustomLocation)입니다.

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

-IsolateEmulatorThread

필드가 사용되지 않습니다. 제공된 경우 값이 무시됩니다. 지정된 CPU 코어 중 하나가 이 가상 머신에 대한 에뮬레이터 스레드를 실행하도록 격리되어 있는지 여부를 나타내는 표시기입니다.

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

-Location

리소스가 있는 지리적 위치

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

-MemorySizeGb

가상 머신의 메모리 크기입니다. 할당은 기비바이트 단위로 측정됩니다.

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

-Name

가상 머신의 이름입니다.

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

-NetworkAttachment

가상 머신에 대한 네트워크 첨부 파일 목록입니다. 생성하려면 NETWORKATTACHMENT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-NetworkData

Base64로 인코딩된 cloud-init 네트워크 데이터입니다.

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

-NoWait

명령을 비동기적으로 실행

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

-OSDiskCreateOption

OS 디스크를 만들기 위한 전략입니다.

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

-OSDiskDeleteOption

OS 디스크를 삭제하기 위한 전략입니다.

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

-OSDiskSizeGb

디스크의 크기입니다. createOption이 임시인 경우 필수입니다. 할당은 기비바이트 단위로 측정됩니다.

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

-PlacementHint

가상 머신에 대한 예약 힌트입니다. 생성하려면 PLACEMENTHINT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

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

-SshPublicKey

ssh 공개 키 목록입니다. 각 키는 adminUsername에 대한 cloud-init ssh_authorized_keys 메커니즘을 사용하여 가상 머신에 추가됩니다. 생성하려면 SSHPUBLICKEY 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-StorageProfileVolumeAttachment

가상 머신에 연결하도록 요청된 볼륨의 리소스 ID입니다.

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

-SubscriptionId

대상 구독의 ID입니다. 값은 UUID여야 합니다.

형식:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Tag

리소스 태그.

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

-UserData

Base64로 인코딩된 cloud-init 사용자 데이터입니다.

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

-VirtioInterface

사용되지 않는 필드입니다. 대신 virtualizationModel을 사용합니다. virtio 인터페이스의 형식입니다.

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

-VMDeviceModel

사용할 디바이스 모델의 형식입니다.

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

-VMImage

이미지를 끌어오는 데 사용되는 전체 URL 및 태그 표기법을 사용하여 현재 OS 디스크에 프로비전된 가상 머신 이미지입니다.

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

-VMImageRepositoryCredentialsPassword

대상 리포지토리의 이미지에 액세스하는 데 사용되는 암호 또는 토큰입니다.

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

-VMImageRepositoryCredentialsRegistryUrl

리포지토리 자격 증명의 유효성을 검사하는 데 사용되는 인증 서버의 URL입니다.

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

-VMImageRepositoryCredentialsUsername

대상 리포지토리의 이미지에 액세스하는 데 사용되는 사용자 이름입니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

출력

IVirtualMachine

다음을 통해 공유