Compartir a través de


Get-SCVirtualDiskDrive

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

Sintaxis

All

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

VM

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

Template

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

ID

Get-SCVirtualDiskDrive
    [-ID] <Guid>
    [-VMMServer <ServerConnection>]
    [-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 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 la unidad de disco virtual en VM02 y los almacena en $VirtDiskDrive. Si, como se supone en este ejemplo, una máquina virtual contiene varias unidades de disco virtual, cada unidad de disco virtual tiene conectado a ella 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 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 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 la unidad de disco virtual, excluyendo los discos de paso a través, que están conectados a la segunda ranura de cualquiera de los canales del IDE. El uso del símbolo @ y los paréntesis garantiza que el comando almacene 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 de 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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

All
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ID

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

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ID
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OnBehalfOfUser

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet opera en nombre del rol de usuario que especifica este parámetro.

Propiedades del parámetro

Tipo:UserRole
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VM

Especifica un objeto de máquina virtual del que este cmdlet obtiene unidades de disco virtual.

Propiedades del parámetro

Tipo:VM
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

VM
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VMMServer

Especifica un objeto de servidor VMM.

Propiedades del parámetro

Tipo:ServerConnection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Template
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Plantilla

Conjuntos de parámetros

Template
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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 .