Update-AzVM
Azure 가상 머신의 상태를 업데이트합니다.
구문
ResourceGroupNameParameterSetName (기본값)
Update-AzVM
[-ResourceGroupName] <String>
-VM <PSVirtualMachine>
[-Tag <Hashtable>]
[-OsDiskWriteAccelerator <Boolean>]
[-UltraSSDEnabled <Boolean>]
[-MaxPrice <Double>]
[-EncryptionAtHost <Boolean>]
[-ProximityPlacementGroupId <String>]
[-VirtualMachineScaleSetId <String>]
[-HostId <String>]
[-CapacityReservationGroupId <String>]
[-AsJob]
[-NoWait]
[-UserData <String>]
[-HibernationEnabled]
[-vCPUCountAvailable <Int32>]
[-vCPUCountPerCore <Int32>]
[-ProcessorMode <String>]
[-SecurityType <String>]
[-EnableVtpm <Boolean>]
[-EnableSecureBoot <Boolean>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-AlignRegionalDisksToVMZone <Boolean>]
[-ScheduledEventsApiVersion <String>]
[-EnableAllInstancesDown <Boolean>]
[-DisableCapacityReservationAssignment]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ExplicitIdentityParameterSet
Update-AzVM
[-ResourceGroupName] <String>
-VM <PSVirtualMachine>
-IdentityType <ResourceIdentityType>
[-Tag <Hashtable>]
[-IdentityId <String[]>]
[-OsDiskWriteAccelerator <Boolean>]
[-UltraSSDEnabled <Boolean>]
[-MaxPrice <Double>]
[-EncryptionAtHost <Boolean>]
[-ProximityPlacementGroupId <String>]
[-VirtualMachineScaleSetId <String>]
[-HostId <String>]
[-CapacityReservationGroupId <String>]
[-AsJob]
[-NoWait]
[-UserData <String>]
[-HibernationEnabled]
[-vCPUCountAvailable <Int32>]
[-vCPUCountPerCore <Int32>]
[-ProcessorMode <String>]
[-SecurityType <String>]
[-EnableVtpm <Boolean>]
[-EnableSecureBoot <Boolean>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-AlignRegionalDisksToVMZone <Boolean>]
[-ScheduledEventsApiVersion <String>]
[-EnableAllInstancesDown <Boolean>]
[-DisableCapacityReservationAssignment]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
IdParameterSetName
Update-AzVM
[-Id] <String>
-VM <PSVirtualMachine>
[-Tag <Hashtable>]
[-OsDiskWriteAccelerator <Boolean>]
[-UltraSSDEnabled <Boolean>]
[-MaxPrice <Double>]
[-EncryptionAtHost <Boolean>]
[-ProximityPlacementGroupId <String>]
[-VirtualMachineScaleSetId <String>]
[-HostId <String>]
[-CapacityReservationGroupId <String>]
[-AsJob]
[-NoWait]
[-UserData <String>]
[-HibernationEnabled]
[-vCPUCountAvailable <Int32>]
[-vCPUCountPerCore <Int32>]
[-ProcessorMode <String>]
[-SecurityType <String>]
[-EnableVtpm <Boolean>]
[-EnableSecureBoot <Boolean>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-AlignRegionalDisksToVMZone <Boolean>]
[-ScheduledEventsApiVersion <String>]
[-EnableAllInstancesDown <Boolean>]
[-DisableCapacityReservationAssignment]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update-AzVM cmdlet은 Azure 가상 머신의 상태를 가상 머신 개체의 상태로 업데이트합니다.
예제
예제 1: 가상 머신 업데이트
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
이 명령은 ResourceGroup11에서 $VirtualMachine 가상 머신을 업데이트합니다.
이 명령은 $VirtualMachine 변수에 저장된 가상 머신 개체를 사용하여 업데이트합니다.
가상 머신 개체를 가져오려면 Get-AzVM cmdlet을 사용합니다.
예제 2: 하이퍼스레딩을 사용하지 않도록 가상 머신을 업데이트합니다.
$resourceGroupName = 'Resource Group Name>'
$vmname = 'Virtual Machine Name';
$domainNameLabel = "d1" + $rgname;
$vCPUsCoreInitial = 2;
$vCPUsAvailableInitial = 4;
$vCPUsCore1 = 1;
$vCPUsAvailable1 = 1;
$vmSize = 'Standard_D4s_v4';
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = "user";
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -Size $vmSize -vCPUCountPerCore $vCPUsCoreInitial -vCPUCountAvailable $vCPUsAvailableInitial;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 2, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 4.
Update-AzVM -ResourceGroupName $rgname -VM $vm -vCPUCountAvailable $vCPUsAvailable1 -vCPUCountPerCore $vCPUsCore1;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 1, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 1.
# Hyperthreading is now disabled for this VM.
예제 3: VM 프로세서 모드 업데이트
$vm = Get-AzVM -ResourceGroupName "myResourceGroup" -Name "myVM"
Update-AzVM -ResourceGroupName "myResourceGroup" -VM $vm -ProcessorMode "Opportunistic"
예제 4: 용량이 부족하여 가상 머신 옵트아웃
$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myVM";
Update-AzVM -ResourceGroupName "myRG" -VM $vm -DisableCapacityReservationAssignment;
이 예제에서는 용량 예약 할당에서 명시적으로 옵트아웃하고 대신 공개적으로 사용 가능한 용량을 사용하도록 가상 머신을 업데이트합니다.
매개 변수
-AlignRegionalDisksToVMZone
지역 디스크를 VM 영역으로 정렬/이동할지 여부를 지정합니다. 배치 속성이 설정된 VM에만 적용됩니다. 이 변경은 되돌릴 수 없습니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-AsJob
백그라운드에서 cmdlet을 실행하고 작업을 반환하여 진행률을 추적합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-CapacityReservationGroupId
할당하는 데 사용되는 용량 예약 그룹의 ID입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
형식: SwitchParameter
Default value: False
와일드카드 지원: False
DontShow: False
별칭: cf(cf)
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-DefaultProfile
Azure 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
형식: IAzureContextContainer
Default value: None
와일드카드 지원: False
DontShow: False
별칭: AzContext, AzureRmContext, AzureCredential
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-DisableCapacityReservationAssignment
가상 머신이 용량 예약 할당에서 명시적으로 옵트아웃되도록 지정합니다.
설정하면 가상 머신은 암시적 또는 명시적으로 용량 예약과 연결되지 않으며 대신 공개적으로 사용 가능한 용량을 사용합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-EnableAllInstancesDown
모든 인스턴스가 다운될 때 예약된 이벤트를 자동으로 승인해야 하는지 여부를 지정합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-EnableSecureBoot
가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-EnableVtpm
가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-EncryptionAtHost
요청에서 사용자가 EncryptionAtHost 속성을 사용하여 가상 머신 또는 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정할 수 있습니다.
이렇게 하면 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화가 활성화됩니다.
매개 변수 속성
형식: Boolean
Default value: False
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-HibernationEnabled
VM에서 최대 절전 모드 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-HostId
호스트의 ID
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-Id
가상 머신의 리소스 ID를 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
IdParameterSetName
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-IdentityId
가상 머신과 연결된 사용자 ID 목록을 지정합니다.
사용자 ID 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft 형식의 ARM 리소스 ID입니다. ManagedIdentity/identities/{identityName}'
매개 변수 속성
형식: String [ ]
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
ExplicitIdentityParameterSet
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-IdentityType
가상 머신에 사용되는 ID의 형식입니다. 유효한 값은 SystemAssigned, UserAssigned, SystemAssignedUserAssigned 및 None입니다.
매개 변수 속성
형식: Nullable<T> [ ResourceIdentityType ]
Default value: None
허용되는 값: SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
와일드카드 지원: False
DontShow: False
매개 변수 집합
ExplicitIdentityParameterSet
Position: Named
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-IfMatch
PUT 및 기타 안전하지 않은 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 서버는 리소스가 나열된 ETag 값 중 하나와 일치하는 경우에만 요청된 리소스를 반환합니다. 현재 리소스를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-IfNoneMatch
GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. 새 레코드 집합을 만들 수 있지만 기존 레코드 집합을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 지원되지 않으므로 서버에서 오류가 발생합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-MaxPrice
우선 순위가 낮은 VM/VMSS에 대해 지불할 최대 가격을 지정합니다. 이 가격은 미국 달러입니다. 이 가격은 VM 크기에 대한 현재 낮은 우선 순위 가격과 비교됩니다. 또한 낮은 우선 순위 VM/VMSS를 생성/업데이트할 때 가격을 비교하며 maxPrice가 현재 낮은 우선 순위 가격보다 큰 경우에만 작업이 성공합니다. 현재 낮은 우선 순위 가격이 VM/VMSS를 만든 후 maxPrice를 초과하는 경우 maxPrice는 우선 순위가 낮은 VM/VMSS를 제거하는 데도 사용됩니다. 가능한 값은 0보다 큰 10진수 값입니다. 예: 0.01538. -1은 가격상의 이유로 우선 순위가 낮은 VM/VMSS를 제거해서는 안 됨을 나타냅니다. 또한 기본 최대 가격은 사용자가 제공하지 않은 경우 -1.
매개 변수 속성
형식: Double
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-NoWait
작업을 시작하고 작업이 완료되기 전에 즉시 반환합니다. 작업이 성공적으로 완료되었는지 확인하려면 다른 메커니즘을 사용합니다.
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-OsDiskWriteAccelerator
OS 디스크에서 WriteAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.
매개 변수 속성
형식: Boolean
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ProcessorMode
프로세서 빈도 동작을 지정합니다. 일반적인 값은 다음과 같습니다 DeterministicOpportunistic.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-ProximityPlacementGroupId
이 가상 머신에 사용할 근접 배치 그룹의 리소스 ID입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ResourceGroupName
가상 머신의 리소스 그룹의 이름을 지정합니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
ResourceGroupNameParameterSetName
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
ExplicitIdentityParameterSet
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-ScheduledEventsApiVersion
전달할 예약된 이벤트 구성 스키마 버전을 결정하기 위해 api-version을 지정합니다. 형식: YYYY-MM-DD. 사용 가능한 API 버전은 다음을 참조하세요 https://learn.microsoft.com/rest/api/compute/scheduled-events .
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-SecurityType
가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 이 속성을 설정하지 않으면 기본적으로 UefiSettings를 사용할 수 없습니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-Tag
리소스 및 리소스 그룹에 이름-값 쌍 집합으로 태그를 지정할 수 있습니다.
리소스에 태그를 추가하면 리소스 그룹 간에 리소스를 그룹화하고 고유한 보기를 만들 수 있습니다.
각 리소스 또는 리소스 그룹에는 최대 15개의 태그가 있을 수 있습니다.
매개 변수 속성
형식: Hashtable
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-UltraSSDEnabled
VM에 UltraSSD_LRS 스토리지 계정 유형이 있는 하나 이상의 관리되는 데이터 디스크가 있는 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다.
스토리지 계정 유형이 UltraSSD_LRS 관리 디스크는 이 속성을 사용하는 경우에만 가상 머신에 추가할 수 있습니다.
매개 변수 속성
형식: Boolean
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-UserData
Base-64로 인코딩되는 VM에 대한 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-vCPUCountAvailable
VM에 사용할 수 있는 vCPU 수를 지정합니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본 동작은 지역에서 사용 가능한 모든 가상 머신 크기를 나열하기 api 응답에 노출된 해당 VM 크기에 사용할 수 있는 vCPU 값으로 설정하는 것입니다.
매개 변수 속성
형식: Int32
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-vCPUCountPerCore
vCPU와 물리적 코어 비율을 지정합니다. 요청 본문에 이 속성이 지정되지 않은 경우 기본 동작은 지역에서 사용 가능한 모든 가상 머신 크기를 나열하기 api 응답에 노출된 VM 크기에 대한 vCPUsPerCore 값으로 설정됩니다. 또한 이 속성을 1로 설정하면 하이퍼 스레딩이 비활성화됩니다.
매개 변수 속성
형식: Int32
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-VirtualMachineScaleSetId
가상 머신을 업데이트해야 하는 Virtual Machine ScaleSet의 ID입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-VM
로컬 가상 머신 개체를 지정합니다.
가상 머신 개체를 가져오려면 Get-AzVM cmdlet을 사용합니다.
이 가상 머신 개체에는 가상 머신에 대한 업데이트된 상태가 포함됩니다.
매개 변수 속성
형식: PSVirtualMachine
Default value: None
와일드카드 지원: False
DontShow: False
별칭: VMProfile
매개 변수 집합
(All)
Position: Named
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: True
나머지 인수의 값: False
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요.
cmdlet이 실행되지 않습니다.
매개 변수 속성
형식: SwitchParameter
Default value: False
와일드카드 지원: False
DontShow: False
별칭: 위스콘신
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
CommonParameters
이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters 를 참조하세요.
출력