Set-SCVirtualHardDisk

Módulo:

VirtualMachineManager

Cambia las propiedades de un objeto de disco duro virtual usado en VMM.

Syntax

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVirtualHardDisk cambia una o varias propiedades de un objeto de disco duro virtual usado en un entorno de Virtual Machine Manager (VMM). Un archivo de disco duro virtual que se usa en VMM es un archivo .vhd basado en Windows, un archivo .vhd basado en Citrix XenServer o un archivo .vmdk basado en VMware.

Entre las propiedades que se pueden cambiar se encuentran:

• Descripción
• habilitado
• Nombre
• Sistema operativo
• Propietario
• rutaDeAccesoDeRecursoCompartido

Un archivo de disco duro virtual puede estar almacenado en la biblioteca VMM o estar conectado a una unidad de disco virtual de una máquina virtual o plantilla.

Para cambiar la configuración de Bus y LUN de una unidad de disco virtual, use el cmdlet Set-SCVirtualDiskDrive .

Ejemplos

Ejemplo 1: Cambiar la descripción de un disco duro virtual

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

El primer comando recupera el objeto de disco duro virtual denominado "WindowsServer2003BootVHD.vhd" de la biblioteca en VMMServer01 y, a continuación, almacena el objeto en la variable $VHD.

El segundo comando cambia la descripción del objeto de disco duro virtual almacenado en $VHD a "Latest Windows Server 2008 R2 Boot VHD".

Ejemplo 2: Habilitación de un disco duro virtual basado en VMware en la biblioteca

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

El primer comando obtiene el objeto de disco duro virtual denominado WindowsServer2008.vmdk y, a continuación, almacena el objeto de disco duro virtual en la variable $VMDK.

El segundo comando deshabilita el objeto de disco duro virtual almacenado en $VMDK.

Ejemplo 3: Especificar un propietario para todos los discos duros virtuales con un propietario "Desconocido"

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

Este comando obtiene todos los objetos de disco duro virtual de la biblioteca VMM cuyo propietario es "Desconocido" y, a continuación, especifica un propietario para cada objeto de disco duro virtual.

Parámetros

-Description

Especifica una descripción para el objeto de disco duro virtual.

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

-Enabled

Habilita un objeto cuando se establece en $True o deshabilita un objeto cuando se establece en $False. Por ejemplo, si desea actualizar software en una plantilla de máquina virtual, puede deshabilitar el objeto de plantilla en la biblioteca VMM para impedir temporalmente que los usuarios utilicen dicho objeto.

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

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-Name

Especifica el nombre de un objeto de VMM.

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

-OperatingSystem

Especifica el tipo de sistema operativo de una máquina virtual. Para enumerar los nombres de todos los sistemas operativos disponibles en VMM, escriba Get-SCOperatingSystem.

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

-Owner

Especifica el propietario de un objeto de VMM en forma de cuenta de usuario de dominio válida.

• Formato de ejemplo: -Owner "Contoso\PattiFuller"
• Formato de ejemplo: -Owner "PattiFuller@Contoso"

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

-ProductKey

Especifica una clave de producto. La clave de producto es un número de 25 dígitos que identifica la licencia del producto. Se puede usar una clave de producto para registrar VMM o un sistema operativo que se va a instalar en una máquina virtual o host.

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

-PROTipID

Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.

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

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-SharePath

Especifica una ruta de acceso a un recurso compartido de biblioteca válido en un servidor de biblioteca existente que usa una ruta de acceso de la convención de nomenclatura universal (UNC).

Formato de ejemplo: -SharePath "\\LibServer01\LibShare"

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

-Tag

Especifica una palabra o frase que se va a asociar a un objeto para que pueda buscar todos los objetos con el conjunto de etiquetas especificado. Puede buscar un subconjunto de etiquetas o puede buscar el conjunto completo de etiquetas.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

Especifica un objeto de función de usuario.

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

-VirtualHardDisk

Especifica un objeto de disco duro virtual.

Type:	VirtualHardDisk
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualHardDisks

Especifica una matriz de objetos de disco duro virtual.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualizationPlatform

Especifica la plataforma de virtualización de un host de máquina virtual administrado por VMM. Los valores permitidos para este parámetro son los siguientes:

• HyperV
• VMwareESX
• Xenserver

Type:	VirtualizationPlatform
Accepted values:	Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

Salidas

VirtualHardDisk

Este cmdlet devuelve un objeto VirtualHardDisk .

Notas

• Requiere un objeto de disco duro virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualHardDisk .

Vínculos relacionados

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualHardDisk
• Move-SCVirtualHardDisk
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive