Get-AzureVM
Recupera información de una o varias máquinas virtuales de Azure.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
ListAllVMs (Es el valor predeterminado).
Get-AzureVM
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
GetVMByServiceAndVMName
Get-AzureVM
[-ServiceName] <String>
[[-Name] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
El cmdlet Get-AzureVM recupera información sobre las máquinas virtuales que se ejecutan en Azure. Devuelve un objeto con información sobre una máquina virtual específica, o si no se especifica ninguna máquina virtual, para todas las máquinas virtuales del servicio especificado de la suscripción actual.
Ejemplos
Ejemplo 1: Recuperación de información en una máquina virtual especificada
PS C:\> Get-AzureVM -ServiceName "ContosoService01" -Name "VirtualMachine02"
Este comando devuelve un objeto con información sobre la máquina virtual VirtualMachine02 que se ejecuta en el servicio en la nube ContosoService01.
Ejemplo 2: Recuperación de información sobre todas las máquinas virtuales
PS C:\> Get-AzureVM -ServiceName "ContosoService01"
Este comando recupera un objeto list con información sobre todas las máquinas virtuales que se ejecutan en el servicio en la nube ContosoService01.
Ejemplo 3: Mostrar una tabla de estados de máquina virtual
PS C:\> Get-AzureVM -ServiceName "ContosoService01" | Format-Table AutoSize -Property "Name",@{Expression={$_.InstanceUpgradeDomain};Label="UpgDom";Align="Right"},"InstanceStatus"
Este comando muestra una tabla que muestra las máquinas virtuales que se ejecutan en el servicio ContosoService01, su dominio de actualización y el estado actual de cada máquina virtual.
Parámetros
-InformationAction
Especifica cómo responde este cmdlet a un evento de información.
Los valores permitidos para este parámetro son los siguientes:
- Continuar
- Ignore
- Inquire
- SilentlyContinue
- Detención
- Suspender
Propiedades del parámetro
| Tipo: | ActionPreference |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | infa |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-InformationVariable
Especifica una variable de información.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Iv |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica el nombre de la máquina virtual para la que se va a recuperar información. Si no se proporciona este parámetro, el cmdlet devuelve un objeto de lista con información sobre todas las máquinas virtuales del servicio especificado.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetVMByServiceAndVMName
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
Propiedades del parámetro
| Tipo: | AzureSMProfile |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ServiceName
Especifica el nombre del servicio en la nube para el que se va a devolver información de máquina virtual.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetVMByServiceAndVMName
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.