Set-SCVirtualHardDisk

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um objeto de disco rígido virtual usado no 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

O cmdlet Set-SCVirtualHardDisk altera uma ou mais propriedades de um objeto de disco rígido virtual usado em um ambiente do VMM (Virtual Machine Manager). Um arquivo de disco rígido virtual usado no VMM é um arquivo .vhd baseado no Windows, um arquivo .vhd baseado em Citrix XenServer ou um arquivo .vmdk baseado em VMware.

As propriedades que você pode alterar incluem:

  • Descrição
  • Habilitada
  • Nome
  • Sistema operacional
  • Proprietário
  • Sharepath

Um arquivo de disco rígido virtual pode ser armazenado na biblioteca do VMM ou pode ser anexado a uma unidade de disco virtual em uma máquina virtual ou modelo.

Para alterar as configurações de Barramento e LUN para uma unidade de disco virtual, use o cmdlet Set-SCVirtualDiskDrive .

Exemplos

Exemplo 1: alterar a descrição de um disco rígido 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"

O primeiro comando recupera o objeto de disco rígido virtual chamado "WindowsServer2003BootVHD.vhd" da biblioteca no VMMServer01 e armazena o objeto na variável $VHD.

O segundo comando altera a descrição do objeto de disco rígido virtual armazenado em $VHD para "VHD de inicialização do Windows Server 2008 R2 mais recente".

Exemplo 2: habilitar um disco rígido virtual baseado em VMware na 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

O primeiro comando obtém o objeto de disco rígido virtual chamado WindowsServer2008.vmdk e armazena o objeto de disco rígido virtual na variável $VMDK.

O segundo comando desabilita o objeto de disco rígido virtual armazenado em $VMDK.

Exemplo 3: especificar um proprietário para todos os discos rígidos virtuais com um proprietário "Desconhecido"

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

Esse comando obtém todos os objetos de disco rígido virtual da biblioteca do VMM cujo proprietário é "Desconhecido" e especifica um proprietário para cada objeto de disco rígido virtual.

Parâmetros

-Description

Especifica uma descrição para o objeto de disco rígido virtual.

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

-Enabled

Habilita um objeto quando definido como $True ou desabilita um objeto quando definido como $False. Por exemplo, se você quiser atualizar o software em um modelo de máquina virtual, poderá desabilitar o objeto de modelo na biblioteca do VMM para impedir temporariamente que os usuários usem esse objeto.

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

-FamilyName

Especifica um nome de família para um recurso físico na biblioteca do VMM. Esse valor é usado em conjunto com Release, Namespace e Type para estabelecer equivalência entre os recursos de biblioteca.

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

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

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

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-Name

Especifica o nome de um objeto VMM.

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

-OperatingSystem

Especifica o tipo de sistema operacional de uma máquina virtual. Para listar os nomes de todos os sistemas operacionais disponíveis no VMM, digite Get-SCOperatingSystem.

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

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válido.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Especifica uma chave do produto. A chave do produto é um número de 25 dígitos que identifica a licença do produto. Uma chave do produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-Release

Especifica uma cadeia de caracteres que descreve a versão de um recurso de biblioteca. O VMM cria automaticamente um valor de versão para cada recurso importado para a biblioteca. Depois que o recurso tiver sido importado, a cadeia de caracteres poderá ser personalizada.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-SharePath

Especifica um caminho para um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção Universal de Nomenclatura).

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

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

-Tag

Especifica uma palavra ou frase a ser associada a um objeto para que você possa pesquisar todos os objetos com o conjunto de marcas especificado. Você pode pesquisar um subconjunto de marcas ou pesquisar o conjunto completo de marcas.

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 um objeto de função de usuário.

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

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

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

-VirtualHardDisks

Especifica uma matriz de objetos de disco rígido 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 a plataforma de virtualização de um host de máquina virtual gerenciado pelo VMM. Os valores aceitáveis para esse parâmetro são:

  • 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 um objeto de servidor do VMM.

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

Saídas

VirtualHardDisk

Este cmdlet retorna um objeto VirtualHardDisk .

Observações

  • Requer um objeto de disco rígido virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualHardDisk .