Get-AzVM

Ottiene le proprietà di una macchina virtuale.

Sintassi

DefaultParamSet (Impostazione predefinita)

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>]

Descrizione

Il cmdlet Get-AzVM ottiene la visualizzazione del modello o la visualizzazione dell'istanza di una macchina virtuale Azure. La visualizzazione del modello è le proprietà specificate dall'utente della macchina virtuale. La visualizzazione dell'istanza è lo stato a livello di istanza della macchina virtuale. Specificare il parametro Status per ottenere la visualizzazione dell'istanza di una macchina virtuale anziché la visualizzazione del modello, ovvero l'impostazione predefinita.

La visualizzazione modello espone FlexProfile come tipo Microsoft.Azure.Management.Compute.Models.FlexProfileSDK , incluso FlexProfile.PreferredVMSize. Azure può distribuire un'alternativa compatibile alle dimensioni preferite; HardwareProfile.VmSize segnala le dimensioni selezionate dal servizio. Sia FlexProfile che vmSize segnalato dal servizio vengono mantenuti quando si passa il modello a Update-AzVM senza PreferredVMSize, senza modificare l'oggetto di input. I risultati di sola visualizzazione dell'istanza restituiti con Status non espongono FlexProfile. FlexProfile è una funzionalità di anteprima che richiede la registrazione della funzionalità e della Microsoft.Compute/FlexProfileEnabled disponibilità della sottoscrizione nell'area di destinazione. Le famiglie di macchine virtuali supportate variano in base all'area.

Esempio

Esempio 1: Ottenere le proprietà del modello della macchina virtuale denominata 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}

Questo comando ottiene la visualizzazione del modello e le proprietà di visualizzazione dell'istanza della macchina virtuale denominata VirtualMachine07.

Esempio 2: Ottenere le proprietà della visualizzazione dell'istanza

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

Questo comando ottiene le proprietà della macchina virtuale denominata VirtualMachine07. Questo comando specifica il parametro Status . Di conseguenza, il comando ottiene solo le proprietà di visualizzazione dell'istanza.

Esempio 3: Ottenere le proprietà per tutte le macchine virtuali in un gruppo di risorse

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

Questo comando ottiene le proprietà per tutte le macchine virtuali nel gruppo di risorse denominato ResourceGroup11.

Esempio 4: Ottenere tutte le macchine virtuali nella sottoscrizione

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

Questo comando ottiene tutte le macchine virtuali nella sottoscrizione.

Esempio 5: Ottenere tutte le macchine virtuali nella posizione.

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

Questo comando ottiene tutte le macchine virtuali nell'area Stati Uniti occidentali.

Esempio 6: Ottenere tutte le macchine virtuali usando il filtro

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

Questo comando ottiene tutte le macchine virtuali con nomi che iniziano con "test"

Esempio 7: Ottenere una macchina virtuale con valore UserData

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=

Il valore UserData deve essere sempre codificato in Base64. Questo comando presuppone che sia già stata creata una macchina virtuale con un valore UserData.

Esempio 8: Esaminare FlexProfile e conservarlo durante un aggiornamento

$vm = Get-AzVM -ResourceGroupName "myRG" -Name "myFlexVM"
$vm.FlexProfile.PreferredVMSize
$vm.HardwareProfile.VmSize
$vm.Tags = @{ workload = "batch" }
Update-AzVM -ResourceGroupName "myRG" -VM $vm

Questo esempio recupera il modello di una macchina virtuale FlexProfile esistente, esamina le dimensioni preferite e selezionate dal servizio e aggiorna i tag mantenendo al tempo stesso FlexProfile e VmSize segnalato dal servizio. Update-AzVM lascia invariate queste proprietà in $vm. Non usare Get-AzVM -Status per questo round trip del modello.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisplayHint

Determina la modalità di visualizzazione dell'oggetto macchina virtuale. I valori validi sono: -- Compact: visualizza solo le proprietà di primo livello - Espandi: visualizza tutte le proprietà in tutti i livelli

Proprietà dei parametri

Tipo:DisplayHintType
Valore predefinito:None
Valori accettati:Compact, Expand
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetVirtualMachineInResourceGroupParamSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Location

Specifica un percorso per le macchine virtuali da elencare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ListLocationVirtualMachinesParamSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della macchina virtuale da ottenere.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False
Alias:ResourceName, VMName

Set di parametri

DefaultParamSet
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Specifica il nome di un gruppo di risorse.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

DefaultParamSet
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ResourceId

ID della macchina virtuale

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetVirtualMachineById
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Status

Indica che questo cmdlet ottiene solo la visualizzazione dell'istanza della macchina virtuale.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserData

UserData per la macchina virtuale, che verrà codificata in base 64. Il cliente non deve passare segreti qui.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

DefaultParamSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
GetVirtualMachineInResourceGroupParamSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
ListLocationVirtualMachinesParamSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Uri

DisplayHintType

Output

PSVirtualMachine

PSVirtualMachineInstanceView