Compartir a través de

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.

Sintaxis

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: Obtención de 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto VMM.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual.

Tipo:VM
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMTemplate

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

Tipo:Template
Alias:Template
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.