Get-AzureVM
Récupère des informations d’une ou de plusieurs machines virtuelles Azure.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.
Syntaxe
ListAllVMs (Par défaut)
Get-AzureVM
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
GetVMByServiceAndVMName
Get-AzureVM
[-ServiceName] <String>
[[-Name] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
L’applet de commande Get-AzureVM récupère des informations sur les machines virtuelles exécutées dans Azure. Elle retourne un objet avec des informations sur une machine virtuelle spécifique, ou si aucune machine virtuelle n’est spécifiée, pour toutes les machines virtuelles du service spécifié de l’abonnement actuel.
Exemples
Exemple 1 : Récupérer des informations sur une machine virtuelle spécifiée
PS C:\> Get-AzureVM -ServiceName "ContosoService01" -Name "VirtualMachine02"
Cette commande retourne un objet avec des informations sur la machine virtuelle VirtualMachine02 exécutée dans le service cloud ContosoService01.
Exemple 2 : Récupérer des informations sur toutes les machines virtuelles
PS C:\> Get-AzureVM -ServiceName "ContosoService01"
Cette commande récupère un objet de liste avec des informations sur toutes les machines virtuelles exécutées dans le service cloud ContosoService01.
Exemple 3 : Afficher une table des états des machines virtuelles
PS C:\> Get-AzureVM -ServiceName "ContosoService01" | Format-Table AutoSize -Property "Name",@{Expression={$_.InstanceUpgradeDomain};Label="UpgDom";Align="Right"},"InstanceStatus"
Cette commande affiche un tableau montrant les machines virtuelles en cours d’exécution sur le service ContosoService01, leur domaine de mise à niveau et l’état actuel de chaque machine virtuelle.
Paramètres
-InformationAction
Spécifie la façon dont cette applet de commande répond à un événement d’information.
Les valeurs valides pour ce paramètre sont :
- Continuer
- Ignorer
- Demander
- SilentlyContinue
- Stop
- Suspendre
Propriétés du paramètre
| Type: | ActionPreference |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | infa |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InformationVariable
Spécifie une variable d’informations.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Iv |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom de la machine virtuelle pour laquelle récupérer des informations. Si ce paramètre n’est pas fourni, l’applet de commande retourne un objet de liste avec des informations sur toutes les machines virtuelles du service spécifié.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
GetVMByServiceAndVMName
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Profile
Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.
Propriétés du paramètre
| Type: | AzureSMProfile |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ServiceName
Spécifie le nom du service cloud pour lequel retourner les informations de machine virtuelle.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
GetVMByServiceAndVMName
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.