Read-SCVirtualMachine
Actualiza las propiedades de una máquina virtual para que la consola VMM muestre información actualizada sobre la máquina virtual.
Syntax
Read-SCVirtualMachine
[-VM] <VM>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Read-SCVirtualMachine
[-VMHost] <Host>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
El cmdlet Read-SCVirtualMachine actualiza las propiedades de una máquina virtual para que la consola de Virtual Machine Manager (VMM) muestre información actualizada sobre la máquina virtual. Las propiedades actualizadas incluyen Name, Status, Host, Owner, CPUAverage, Service, OperatingSystem y otras propiedades.
Ejemplos
Ejemplo 1: Actualizar información sobre una máquina virtual específica
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM
El primer comando obtiene el objeto de máquina virtual denominado VM01 y, a continuación, almacena ese objeto en la variable $VM.
El segundo comando actualiza las propiedades de la máquina virtual almacenada en $VM. Una vez que este comando finaliza correctamente, muestra información actual sobre esta máquina virtual.
Ejemplo 2: Actualización de todas las máquinas virtuales en hosts cuyo nombre coincide con la cadena especificada
PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine
El primer comando obtiene todos los objetos de máquina virtual de VMMServer01 implementados en hosts cuyo nombre contiene la cadena VMM y, a continuación, almacena esos objetos de máquina virtual en la matriz $VMs.
El segundo comando actualiza las propiedades de cada objeto de máquina virtual almacenado en $VMs.
Parámetros
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Especifica un objeto de máquina virtual.
Type: | VM |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMHost
Especifica un objeto host de máquina virtual. VMM admite hosts de Hyper-V, hosts de VMware ESX y hosts de Citrix XenServer.
Para obtener más información sobre cada tipo de host, consulte el cmdlet Add-SCVMHost .
Type: | Host |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Salidas
VirtualMachine
Notas
- Este cmdlet requiere un objeto de máquina virtual, que se puede recuperar mediante el cmdlet Get-SCVirtualMachine .
Vínculos relacionados
- Add-SCVMHost
- Get-SCUserRole
- Get-SCVirtualMachine
- Move-SCVirtualMachine
- New-SCVirtualMachine
- Register-SCVirtualMachine
- Remove-SCVirtualMachine
- Repair-SCVirtualMachine
- Reset-SCVirtualMachine
- Resume-SCVirtualMachine
- Set-SCVirtualMachine
- Start-SCVirtualMachine
- Stop-SCVirtualMachine
- Suspend-SCVirtualMachine