Get-SCVirtualHardDisk

Referencia

Módulo:: VirtualMachineManager

Obtiene objetos de disco duro virtual de una máquina virtual, de una plantilla o como un archivo independiente almacenado en la biblioteca VMM.

Syntax

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Get-SCVirtualHardDisk obtiene objetos de disco duro virtual de una máquina virtual, desde una plantilla o como un archivo independiente almacenado en la biblioteca de Virtual Machine Manager (VMM).

Un disco duro virtual puede ser un archivo .vhd basado en Windows, un archivo .vhd basado en Citrix XenServer o un archivo VMware-based.vmdk. Un disco duro virtual se puede almacenar como un objeto independiente en la biblioteca VMM, conectado a una unidad de disco virtual en una plantilla o conectado a una unidad de disco virtual en una máquina virtual implementada o almacenada.

Ejemplos

Ejemplo 1: Obtener un objeto de disco duro virtual de la biblioteca

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

Este comando obtiene el objeto de disco duro virtual denominado VHD01.vhd almacenado en LibraryServer01 y, a continuación, almacena el objeto en la variable $VHD.

Ejemplo 2: Obtención de un objeto de disco duro virtual de una máquina virtual

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

El primer comando se conecta a VMMServer01.

El segundo comando obtiene el objeto de máquina virtual denominado VM01, selecciona todos los discos duros virtuales de VM01 cuyo nombre incluye la cadena "DataDisk" y, a continuación, almacena los objetos de disco duro virtual devueltos en la variable $VHD.

Ejemplo 3: Obtener un objeto de disco duro virtual de una plantilla específica

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

Este comando obtiene el objeto de plantilla denominado Template01 de la biblioteca y muestra todos los objetos de disco duro virtual de esa plantilla.

Parámetros

-All

Indica que este cmdlet obtiene todos los objetos subordinados independientemente del objeto primario. Por ejemplo, el comando Get-SCVirtualDiskDrive -All obtiene todos los objetos de unidad de disco virtual, independientemente del objeto de máquina virtual o del objeto de plantilla al que está asociado cada objeto de unidad de disco virtual.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FamilyName

Especifica un nombre de familia para un recurso físico en la biblioteca VMM. Este valor se usa junto con Release, Namespace y Type para establecer la equivalencia entre los recursos de biblioteca.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ID

Especifica el identificador numérico como un identificador único global, o GUID, para un objeto específico.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifica el nombre de un objeto de VMM.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-Release

Especifica una cadena que describe la versión de un recurso de biblioteca. VMM crea automáticamente un valor de versión para cada recurso importado en la biblioteca. Una vez importado el recurso, se puede personalizar la cadena.

Type:	String
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:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Especifica un objeto de servidor VMM.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMTemplate

Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.

Type:	Template
Aliases:	Template
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Salidas

VirtualHardDisk

Este cmdlet devuelve un objeto VirtualHardDisk .

Notas

Requiere un objeto de máquina virtual VMM o un objeto de plantilla VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualMachine o el cmdlet Get-SCVMTemplate , respectivamente.