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 .