Get-AzVM
가상 머신의 속성을 가져옵니다.
구문
DefaultParamSet (기본값)
Get-AzVM
[[-ResourceGroupName] <String>]
[[-Name] <String>]
[-Status]
[-UserData]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetVirtualMachineInResourceGroupParamSet
Get-AzVM
[-ResourceGroupName] <String>
[-Name] <String>
[-Status]
[-DisplayHint <DisplayHintType>]
[-UserData]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ListLocationVirtualMachinesParamSet
Get-AzVM
-Location <String>
[-Status]
[-UserData]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
GetVirtualMachineById
Get-AzVM
-ResourceId <String>
[-Status]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-AzVM cmdlet은 Azure 가상 머신의 모델 보기 또는 인스턴스 뷰를 가져옵니다. 모델 뷰는 가상 머신의 사용자가 지정한 속성입니다. 인스턴스 뷰는 가상 머신의 인스턴스 수준 상태입니다. 기본값인 모델 보기 대신 가상 머신의 인스턴스 보기를 가져올 상태 매개 변수를 지정합니다.
모델 뷰는 을 포함하여 FlexProfile.PreferredVMSizeSDK 형식Microsoft.Azure.Management.Compute.Models.FlexProfile으로 노출됩니다FlexProfile.
Azure 기본 설정 크기에 대한 호환 가능한 대안을 배포할 수 있습니다. HardwareProfile.VmSize 는 서비스에서 선택한 크기를 보고합니다.
FlexProfile 및 서비스 보고 VmSize는 입력 개체를 변경하지 않고 PreferredVMSize 없이 Update-AzVM에 모델을 전달할 때 유지됩니다.
상태와 함께 반환된 인스턴스 보기 전용 결과는 FlexProfile을 노출하지 않습니다.
FlexProfile은 대상 지역에서 구독 기능 및 가용성을 Microsoft.Compute/FlexProfileEnabled 등록해야 하는 미리 보기 기능입니다. 지원되는 VM 제품군은 지역에 따라 다릅니다.
예제
예제 1: VirtualMachine07이라는 가상 머신의 모델 속성 가져오기
Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
ResourceGroupName : ResourceGroup11
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup11/providers/M
icrosoft.Compute/virtualMachines/VirtualMachine07
VmId : 00000000-0000-0000-0000-000000000000
Name : VirtualMachine07
Type : Microsoft.Compute/virtualMachines
Location : eastus
Tags : {"creationSource":"acs-VirtualMachine07"}
AvailabilitySetReference : {Id}
DiagnosticsProfile : {BootDiagnostics}
Extensions : {linuxdiagnostic, waitforleader}
HardwareProfile : {VmSize}
NetworkProfile : {NetworkInterfaces}
OSProfile : {ComputerName, AdminUsername, LinuxConfiguration, Secrets}
ProvisioningState : Succeeded
StorageProfile : {ImageReference, OsDisk, DataDisks}
이 명령은 VirtualMachine07이라는 가상 머신의 모델 뷰 및 인스턴스 뷰 속성을 가져옵니다.
예제 2: 인스턴스 보기 속성 가져오기
Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07" -Status
ResourceGroupName : ResourceGroup11
Name : VirtualMachine07
Disks[0] :
Name : VirtualMachine07-osdisk
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Provisioning succeeded
Time : 3/1/2019 12:59:30 AM
Extensions[0] :
Name : linuxdiagnostic
Type : Microsoft.OSTCExtensions.LinuxDiagnostic
TypeHandlerVersion : 2.3.9029
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Provisioning succeeded
Message : Invalid config settings given: Empty storageAccountName. Install will proceed, but enable
can't proceed, in which case it's still considered a success as it's an external error.
Extensions[1] :
Name : waitforleader
Type : Microsoft.OSTCExtensions.CustomScriptForLinux
TypeHandlerVersion : 1.5.4
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Provisioning succeeded
Message : Command is finished.
---stdout---
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
waiting for leader.mesos
PING leader.mesos (xxx.xx.x.x) 56(84) bytes of data.
64 bytes from xxx.xx.x.x: icmp_seq=1 ttl=64 time=0.022 ms
--- leader.mesos ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 0.022/0.022/0.022/0.000 ms
leader.mesos up
---errout---
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
ping: unknown host leader.mesos
PlatformFaultDomain : 0
PlatformUpdateDomain : 0
VMAgent :
VmAgentVersion : 2.2.37
ExtensionHandlers[0] :
Type : Microsoft.OSTCExtensions.LinuxDiagnostic
TypeHandlerVersion : 2.3.9029
Status :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Ready
Message : Plugin enabled
ExtensionHandlers[1] :
Type : Microsoft.OSTCExtensions.CustomScriptForLinux
TypeHandlerVersion : 1.5.4
Status :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Ready
Message : Plugin enabled
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Ready
Message : Guest Agent is running
Time : 3/1/2019 2:04:12 AM
Statuses[0] :
Code : ProvisioningState/succeeded
Level : Info
DisplayStatus : Provisioning succeeded
Time : 3/1/2019 1:01:57 AM
Statuses[1] :
Code : PowerState/running
Level : Info
DisplayStatus : VM running
이 명령은 VirtualMachine07이라는 가상 머신의 속성을 가져옵니다. 이 명령은 Status 매개 변수를 지정합니다. 따라서 명령은 인스턴스 뷰 속성만 가져옵니다.
예제 3: 리소스 그룹의 모든 가상 머신에 대한 속성 가져오기
Get-AzVM -ResourceGroupName "ResourceGroup11"
ResourceGroupName Name Location VmSize OsType NIC
----------------- ---- -------- ------ ------ ---
ResourceGroup11 test1 eastus Standard_DS1_v2 Windows test1
ResourceGroup11 test2 westus Standard_DS1_v2 Windows test2
ResourceGroup11 test3 eastus Standard_DS1_v2 Windows test3
이 명령은 ResourceGroup11이라는 리소스 그룹의 모든 가상 머신에 대한 속성을 가져옵니다.
예제 4: 구독의 모든 가상 머신 가져오기
Get-AzVM
ResourceGroupName Name Location VmSize OsType NIC
----------------- ---- -------- ------ ------ ---
TEST1 test1 eastus Standard_DS1_v2 Windows test1
TEST1 test2 westus Standard_DS1_v2 Windows test2
TEST1 test3 eastus Standard_DS1_v2 Windows test3
TEST2 test4 westus Standard_DS1_v2 Windows test4
TEST2 test5 eastus Standard_DS1_v2 Windows test5
이 명령은 구독의 모든 가상 머신을 가져옵니다.
예제 5: 위치에 있는 모든 가상 머신을 가져옵니다.
Get-AzVM -Location "westus"
ResourceGroupName Name Location VmSize OsType NIC
----------------- ---- -------- ------ ------ ---
TEST1 test2 westus Standard_DS1_v2 Windows test2
TEST2 test4 westus Standard_DS1_v2 Windows test4
이 명령은 미국 서부 지역의 모든 가상 머신을 가져옵니다.
예제 6: 필터링을 사용하여 모든 가상 머신 가져오기
Get-AzVM -Name test*
ResourceGroupName Name Location VmSize OsType NIC
----------------- ---- -------- ------ ------ ---
TEST1 test1 eastus Standard_DS1_v2 Windows test1
TEST1 test2 westus Standard_DS1_v2 Windows test2
TEST1 test3 eastus Standard_DS1_v2 Windows test3
TEST2 test4 westus Standard_DS1_v2 Windows test4
TEST2 test5 eastus Standard_DS1_v2 Windows test5
이 명령은 이름이 "test"로 시작하는 모든 가상 머신을 가져옵니다.
예제 7: UserData 값을 사용하여 VM 가져오기
Get-AzVM -ResourceGroupName <Resource Group Name> -Name <VM Name> -UserData;
ResourceGroupName : <>
Id : /subscriptions/<Subscription Id>/resourceGroups/<Resource Group Name>/providers/Microsoft
.Compute/virtualMachines/<VM Name>
VmId : <VM Id>
Name : <VM Name>
Type : Microsoft.Compute/virtualMachines
Location : eastus
Tags :
{"azsecpack":"nonprod","platformsettings.host_environment.service.platform_optedin_for_rootcerts":"true"}
Extensions : {Microsoft.Azure.Geneva.GenevaMonitoring,
Microsoft.Azure.Security.AntimalwareSignature.AntimalwareConfiguration}
HardwareProfile : {VmSize}
NetworkProfile : {NetworkInterfaces}
OSProfile : {ComputerName, AdminUsername, WindowsConfiguration, Secrets, AllowExtensionOperations,
RequireGuestProvisionSignal}
ProvisioningState : Succeeded
StorageProfile : {ImageReference, OsDisk, DataDisks}
UserData : bm90IGVuY29kZWQ=
UserData 값은 항상 Base64로 인코딩되어야 합니다. 이 명령은 UserData 값을 사용하여 VM을 이미 만들었다고 가정합니다.
예제 8: FlexProfile 검사 및 업데이트 중 유지
$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myFlexVM"
$vm.FlexProfile.PreferredVMSize
$vm.HardwareProfile.VmSize
$vm.Tags = @{ workload = "batch" }
Update-AzVM -ResourceGroupName "myRG" -VM $vm
이 예제에서는 기존 FlexProfile VM의 모델을 검색하고, 기본 설정 및 서비스에서 선택한 크기를 검사하고, FlexProfile 및 서비스에서 보고한 VmSize를 모두 유지하면서 태그를 업데이트합니다.
Update-AzVM 은 이러한 속성을 변경되지 않은 상태로 둡니다 $vm.
이 모델 왕복에 Get-AzVM -Status 를 사용하지 마세요.
매개 변수
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
| 형식: | IAzureContextContainer |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | AzContext, AzureRmContext, AzureCredential |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DisplayHint
가상 머신 개체가 표시되는 방법을 결정합니다. 유효한 값은 다음과 같습니다. -- Compact: 최상위 속성만 표시합니다. 확장: 모든 수준의 모든 속성을 표시합니다.
매개 변수 속성
| 형식: | DisplayHintType |
| Default value: | None |
| 허용되는 값: | Compact, Expand |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetVirtualMachineInResourceGroupParamSet
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Location
나열할 가상 머신의 위치를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ListLocationVirtualMachinesParamSet
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Name
가져올 가상 머신의 이름을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
| 별칭: | ResourceName, VMName |
매개 변수 집합
DefaultParamSet
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ResourceGroupName
리소스 그룹의 이름을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
DefaultParamSet
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ResourceId
VM의 ID
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetVirtualMachineById
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Status
이 cmdlet은 가상 머신의 인스턴스 뷰만 가져옵니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserData
Base-64로 인코딩되는 VM에 대한 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
DefaultParamSet
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
GetVirtualMachineInResourceGroupParamSet
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
ListLocationVirtualMachinesParamSet
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
