Compartir a través de

Get-SCVirtualDiskDrive

  • Referencia
Módulo:
VirtualMachineManager

Obtiene unidades de disco virtual en una plantilla de máquina virtual o en una máquina virtual.

Sintaxis

Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Get-SCVirtualDiskDrive obtiene objetos de unidad de disco virtual de Virtual Machine Manager (VMM). Estas unidades de disco virtual se pueden configurar en plantillas de máquina virtual almacenadas en la biblioteca o en máquinas virtuales implementadas en un host o almacenadas en la biblioteca.

Ejemplos

Ejemplo 1: Obtención de todas las unidades de disco virtual en el entorno de VMM

PS C:\> Get-SCVirtualDiskDrive -VMMServer "VMMServer01.Contoso.com" -All

Este comando obtiene todas las unidades de disco virtual enlazadas a todas las máquinas virtuales registradas en VMM en VMMServer01. El comando muestra información sobre cada unidad de disco virtual.

Ejemplo 2: Obtención de unidades de disco virtual para una máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object {$_.Name -Eq "VM02"} 
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> $VirtDiskDrive

El primer comando obtiene el objeto de máquina virtual denominado VM02 mediante el cmdlet Get-SCVirtualMachine. El comando almacena ese objeto en la variable $VM.

El segundo comando obtiene todos los objetos de unidad de disco virtual en VM02 y almacena esos objetos en $VirtDiskDrive. Si, como se supone en este ejemplo, una máquina virtual contiene varias unidades de disco virtual, cada unidad de disco virtual se ha conectado a él ya sea un disco duro virtual o un disco de paso a través.

El último comando muestra las propiedades de cada unidad de disco virtual en VM02. Esta información incluye el nombre de cualquier disco duro virtual y la ruta de acceso de la unidad física en el host para los discos de paso a través.

Ejemplo 3: Recuento de unidades de disco virtual, excepto discos de paso a través

PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -All | Where-Object {$_.BusType -Eq "IDE" -And $_.PassThroughDisk -Eq $Null -And $_.LUN -Eq 1 -And ($_.Bus -Eq 0 -Or $_.Bus -Eq 1)})
PS C:\> $VirtDiskDrive.Count

El primer comando obtiene los objetos de unidad de disco virtual, excepto los discos de paso a través, que están conectados a la segunda ranura de cualquiera de los canales IDE. El uso del símbolo @ y los paréntesis garantiza que el comando almacena los resultados en una matriz incluso si el comando devuelve un solo objeto o un valor de $Null.

El segundo comando muestra el número de objetos de unidad de disco virtual que coinciden con los criterios de filtro.

Ejemplo 4: Obtención de unidades de disco virtual para todas las plantillas de máquina virtual

PS C:\> $Templates = @(Get-SCVMTemplate)
PS C:\> $Templates | ForEach-Object {Get-SCVirtualDiskDrive -Template $_ | Where-Object {$_.BusType -Eq "IDE"}} | Format-List Name,BusType,Bus,LUN

El primer comando obtiene todas las plantillas de máquina virtual y, a continuación, almacena esos objetos en la matriz $Templates.

El segundo comando pasa cada objeto de plantilla de máquina virtual almacenado en $Templates al cmdlet ForEach-Object. Ese cmdlet obtiene todos los objetos de unidad de disco para cada plantilla. A continuación, el comando selecciona solo los objetos de unidad de disco virtual que usan un tipo de bus IDE y pasa esos objetos al cmdlet Format-List, que muestra el nombre, el tipo de bus, el bus y el LUN para cada objeto de unidad de disco virtual.

Parámetros

-All

Indica que este cmdlet recupera una lista completa de todos los objetos de unidad de disco virtual independientemente del objeto primario.

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

-ID

Especifica el identificador único de la unidad de disco virtual que obtiene este cmdlet.

Tipo:Guid
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-VM

Especifica un objeto de máquina virtual del que este cmdlet obtiene unidades de disco 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 que se usa para crear máquinas virtuales que contienen unidades de disco virtual que obtiene este cmdlet.

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

Salidas

VirtualDiskDrive

Este cmdlet devuelve un objeto VirtualDiskDrive.

Notas

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