Get-AzVM

Référence

Module:: Az.Compute

Obtient les propriétés d’une machine virtuelle.

Syntaxe

Get-AzVM
   [[-ResourceGroupName] <String>]
   [[-Name] <String>]
   [-Status]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Status]
   [-DisplayHint <DisplayHintType>]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   -Location <String>
   [-Status]
   [-UserData]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzVM
   [-Status]
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzVM obtient la vue de modèle ou l’affichage d’instance d’une machine virtuelle Azure. La vue de modèle est les propriétés spécifiées par l’utilisateur de la machine virtuelle. La vue d’instance est l’état au niveau de l’instance de la machine virtuelle. Spécifiez le paramètre Status pour obtenir la vue d’instance d’une machine virtuelle au lieu de la vue de modèle, qui est la valeur par défaut.

Exemples

Exemple 1 : Obtenir les propriétés du modèle de la machine virtuelle nommée 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}

Cette commande obtient les propriétés de vue de modèle et d’instance de la machine virtuelle nommée VirtualMachine07.

Exemple 2 : Obtenir les propriétés de la vue d’instance

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

Cette commande obtient les propriétés de la machine virtuelle nommée VirtualMachine07. Cette commande spécifie le paramètre Status . Par conséquent, la commande obtient uniquement les propriétés d’affichage d’instance.

Exemple 3 : Obtenir des propriétés pour toutes les machines virtuelles d’un groupe de ressources

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

Cette commande obtient les propriétés de toutes les machines virtuelles du groupe de ressources nommé ResourceGroup11.

Exemple 4 : Obtenir toutes les machines virtuelles de votre abonnement

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

Cette commande obtient toutes les machines virtuelles de votre abonnement.

Exemple 5 : Obtenir toutes les machines virtuelles à l’emplacement.

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

Cette commande obtient toutes les machines virtuelles de la région USA Ouest.

Exemple 6 : Obtenir toutes les machines virtuelles à l’aide du filtrage

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

Cette commande obtient toutes les machines virtuelles dont les noms commencent par « test »

Exemple 7 : Obtenir une machine virtuelle avec la valeur 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=

La valeur UserData doit toujours être encodée en Base64. Cette commande suppose que vous avez déjà créé une machine virtuelle avec une valeur UserData.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisplayHint

Détermine la façon dont l’objet de machine virtuelle est affiché. Les valeurs valides sont : -- Compact : affiche uniquement les propriétés de niveau supérieur -- Développer : affiche toutes les propriétés de tous les niveaux

Type:	DisplayHintType
Valeurs acceptées:	Compact, Expand
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Location

Spécifie un emplacement pour les machines virtuelles à répertorier.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Spécifie le nom de la machine virtuelle à obtenir.

Type:	String
Alias:	ResourceName, VMName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	True

-ResourceGroupName

Spécifie le nom d’un groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	True

-ResourceId

ID de la machine virtuelle

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Status

Indique que cette applet de commande obtient uniquement la vue d’instance de la machine virtuelle.

Type:	SwitchParameter
Position:	2
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-UserData

UserData pour la machine virtuelle, qui sera encodée en base 64. Le client ne doit pas transmettre de secrets ici.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

Entrées

String

Uri

DisplayHintType

Sorties

PSVirtualMachine

PSVirtualMachineInstanceView

Partager via

Get-AzVM

Syntaxe

Description

Exemples

Exemple 1 : Obtenir les propriétés du modèle de la machine virtuelle nommée VirtualMachine07

Exemple 2 : Obtenir les propriétés de la vue d’instance

Exemple 3 : Obtenir des propriétés pour toutes les machines virtuelles d’un groupe de ressources

Exemple 4 : Obtenir toutes les machines virtuelles de votre abonnement

Exemple 5 : Obtenir toutes les machines virtuelles à l’emplacement.

Exemple 6 : Obtenir toutes les machines virtuelles à l’aide du filtrage

Exemple 7 : Obtenir une machine virtuelle avec la valeur UserData

Paramètres

-DefaultProfile

-DisplayHint

-Location

-Name

-ResourceGroupName

-ResourceId

-Status

-UserData

Entrées

Sorties

Ressources supplémentaires

Partager via

Get-AzVM

Syntaxe

Description

Exemples

Exemple 1 : Obtenir les propriétés du modèle de la machine virtuelle nommée VirtualMachine07

Exemple 2 : Obtenir les propriétés de la vue d’instance

Exemple 3 : Obtenir des propriétés pour toutes les machines virtuelles d’un groupe de ressources

Exemple 4 : Obtenir toutes les machines virtuelles de votre abonnement

Exemple 5 : Obtenir toutes les machines virtuelles à l’emplacement.

Exemple 6 : Obtenir toutes les machines virtuelles à l’aide du filtrage

Exemple 7 : Obtenir une machine virtuelle avec la valeur UserData

Paramètres

-DefaultProfile

-DisplayHint

-Location

-Name

-ResourceGroupName

-ResourceId

-Status

-UserData

Entrées

Sorties

Liens associés

Ressources supplémentaires