Get-SCVirtualDiskDrive

Referencia

Módulo:: VirtualMachineManager

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

Syntax

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 da por supuesto en este ejemplo, una máquina virtual contiene varias unidades de disco virtuales, cada unidad de disco virtual se ha conectado a la misma mediante un disco virtual o bien un disco de acceso directo.

El último comando muestra las propiedades de cada unidad de disco virtual en VM02. Esta información incluye el nombre de los discos duros virtuales 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 los 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 $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.

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

-ID

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

Type:	Guid
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
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

-VM

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

Type:	Template
Aliases:	Template
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 .