Partilhar 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 Virtual Machine Manager (VMM). Um arquivo de disco rígido virtual usado no VMM é um arquivo .vhd baseado no Windows, um arquivo .vhd baseado no Citrix XenServer ou um arquivo .vmdk baseado em VMware.

As propriedades que podem ser alteradas incluem:

  • Descrição
  • Ativado
  • Designação
  • Sistema Operativo
  • 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 de 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, em seguida, armazena o objeto na variável $VHD.

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

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, em seguida, armazena o objeto de disco rígido virtual na variável $VMDK.

O segundo comando desativa o objeto de disco rígido virtual armazenado no $VMDK.

Exemplo 3: Especifique 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"

Este comando obtém todos os objetos de disco rígido virtual da biblioteca do VMM cujo proprietário é "Desconhecido" e, em seguida, 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 da biblioteca.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Owner

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

  • Exemplo de formato: -Owner "Contoso\PattiFuller"
  • Exemplo de formato: -Owner "PattiFuller@Contoso"
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 de produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Release

Especifica uma cadeia de caracteres que descreve a liberaçã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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 de Nomenclatura Universal).

Exemplo de formato: -SharePath "\\LibServer01\LibShare"

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tag

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

Tipo:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Tipo:VirtualHardDisk
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualHardDisks

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

Tipo:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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:

  • HiperV
  • VMwareESX
  • XENServer
Tipo:VirtualizationPlatform
Valores aceites:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

VirtualHardDisk

Este cmdlet retorna um objeto VirtualHardDisk.

Notas

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