Compartilhar via

Set-SCVirtualHardDisk

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um objeto de disco rígido virtual usado no VMM.

Sintaxe

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
  • Habilitado
  • 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FamilyName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystem

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

Tipo:OperatingSystem
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Owner

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

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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"

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:System.Collections.Generic.List`1[System.String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserRole

Especifica um objeto de função de usuário.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Tipo:VirtualHardDisk
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualHardDisks

Especifica uma matriz de objetos de disco rígido virtual.

Tipo:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualizationPlatform

Especifica a plataforma de virtualização de um host de máquina virtual gerenciado pelo VMM. Os valores aceitáveis para este parâmetro são:

  • HyperV
  • VMwareESX
  • XENServer
Tipo:VirtualizationPlatform
Valores aceitos:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualHardDisk

Esse 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.