Partilhar via

Set-SCVirtualHardDisk

  • Referência
Módulo:
VirtualMachineManager

Altera as propriedades de um objeto de disco rígido virtual utilizado em 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 utilizado num ambiente virtual de Gerente de Máquinas (VMM). Um ficheiro de disco rígido virtual utilizado em VMM é um ficheiro .vhd baseado no Windows, um ficheiro Citrix XenServer baseado em .vhd ou um ficheiro VMware.vmdk baseado em VMware.

As propriedades que pode alterar incluem:

  • Description
  • Ativado
  • Name
  • Sistema Operativo
  • Proprietário
  • SharePath

Um ficheiro de disco rígido virtual pode ser armazenado na biblioteca VMM, ou pode ser ligado a uma unidade de disco virtual numa máquina ou modelo virtual.

Para alterar as definições de Bus e LUN para uma unidade de disco virtual, utilize 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") da biblioteca em 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 em $VHD para "O Mais Recente Windows Server 2008 R2 Boot VHD".

Exemplo 2: Ativar 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 em $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 VMM cujo proprietário é "Desconhecido", e depois 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

Ativa um objeto quando definido para $True ou desativa um objeto quando definido para $False. Por exemplo, se pretender atualizar o software num modelo de máquina virtual, pode desativar o objeto do modelo na biblioteca VMM para impedir temporariamente os utilizadores de utilizarem 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 VMM. Este valor é usado em conjunto com Release, Namespace e Type para estabelecer equivalência entre os recursos da 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 funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este 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 operativo para uma máquina virtual. Para listar os nomes de todos os sistemas operativos disponíveis em VMM, escreva 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 sob a forma de uma conta de utilizador de domínio válida.

  • 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 de 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 registar VMM ou um sistema operativo para ser instalado numa máquina virtual ou hospedeiro.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-Release

Especifica uma cadeia que descreve a libertação de um recurso de biblioteca. A VMM cria automaticamente um valor de libertação para cada recurso importado para a biblioteca. Depois de importado o recurso, a cadeia pode ser personalizada.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-SharePath

Especifica um caminho para uma partilha de biblioteca válida num servidor de biblioteca existente que usa um caminho da Convenção Universal de Nomeação (UNC).

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 para associar a um objeto para que possa pesquisar todos os objetos com o conjunto especificado de tags. Pode procurar um subconjunto de tags ou pode procurar o conjunto completo de tags.

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 do utilizador.

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 hospedeiro de máquinas virtuais gerido por VMM. Os valores aceitáveis para este 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 VMM.

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

Saídas

VirtualHardDisk

Este cmdlet devolve um objeto VirtualHardDisk .

Notas

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