Set-SCVirtualHardDiskConfiguration

  • Referência
Módulo:
VirtualMachineManager

Modifica as informações de configuração de disco rígido virtual contidas em uma configuração de máquina virtual.

Syntax

Set-SCVirtualHardDiskConfiguration
   [-SourceDisk <StandaloneVirtualHardDisk>]
   [-PinSourceLocation <Boolean>]
   [-DestinationLocation <String>]
   [-PinDestinationLocation <Boolean>]
   [-FileName <String>]
   [-PinFileName <Boolean>]
   [-DeploymentOption <DeploymentOption>]
   [-StorageDisk <StorageDisk>]
   [-StorageClassification <StorageClassification>]
   [-StorageQoSPolicy <StorageQoSPolicy>]
   [-PinStorageDisk <Boolean>]
   [-ParentVirtualHardDiskPath <String>]
   [-ParentVirtualHardDiskDestinationPath <String>]
   [-FileInjectionSourceLocation <String>]
   [-FileInjectionDestinationLocation <String>]
   [-FileInjectionDestinationPartition <Int16>]
   -VHDConfiguration <VirtualHardDiskConfiguration>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualHardDiskConfiguration modifica as informações de configuração de disco rígido virtual contidas em uma configuração de máquina virtual.

Exemplos

Exemplo 1: Definir as propriedades de uma configuração de disco rígido virtual

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VHDConfig = Get-SCVirtualHardDiskConfiguration -VMConfiguration $VMConfig[0]
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Win2k8R2BaseDisk.vhd"
PS C:\> Set-SCVirtualHardDiskConfiguration -VHDConfiguration $VHDConfig -SourceDisk $VHD -PinSourceLocation $True

O primeiro comando obtém o objeto de configuração de serviço chamado Service01 e armazena o objeto na variável $ServiceConfig.

O segundo comando obtém a configuração da camada de computador para o objeto de configuração de serviço armazenado em $ServiceConfig e armazena o objeto na variável $TierConfig.

O terceiro comando obtém a configuração da máquina virtual para a configuração da camada de computador armazenada em $TierConfig e armazena o objeto na variável $VMConfig.

O quarto comando obtém a configuração de disco rígido virtual para a primeira configuração de máquina virtual armazenada em $VMConfig e armazena o objeto na variável $VHDConfig.

O quinto comando obtém o objeto de disco rígido virtual chamado Win2k8R2BaseDisk.vhd da biblioteca e armazena o objeto na variável $VHD.

O último comando atualiza a propriedade PinSourceLocation na configuração de disco rígido virtual armazenada em $VHDConfig para o disco rígido virtual de origem armazenado em $VHD fixar o valor do disco rígido virtual de origem, impedindo assim que ele seja alterado durante o posicionamento.

Parâmetros

-DeploymentOption

Especifica a opção de implantação de um disco rígido virtual. Os valores aceitáveis para esse parâmetro são:

  • Nenhum
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk
Type:DeploymentOption
Accepted values:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationLocation

Especifica o caminho de destino para ou em um disco rígido virtual.

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

-FileInjectionDestinationLocation

Especifica o caminho da pasta de destino (caminho relativo para a raiz da partição) em que os arquivos de origem são injetados no VHD selecionado antes de ativar a máquina virtual pela primeira vez.

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

-FileInjectionDestinationPartition

Especifica a partição de destino do VHD selecionado em que os arquivos de origem são injetados antes de ativar a máquina virtual pela primeira vez.

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

-FileInjectionSourceLocation

Especifica o local (uma URL) dos arquivos a serem injetados na máquina virtual antes de ativar a máquina virtual pela primeira vez.

Quando uma pasta é especificada, todos os arquivos nessa pasta são injetados no local de destino especificado.

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

-FileName

Especifica o nome do arquivo a ser usado quando você renomeia um arquivo de disco rígido virtual ao adicioná-lo a uma máquina virtual.

Type:String
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

-ParentVirtualHardDiskDestinationPath

Especifica o caminho de destino para o disco rígido virtual pai.

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

-ParentVirtualHardDiskPath

Especifica o caminho para o disco rígido virtual pai a ser usado ao criar um disco de diferenciação.

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

-PinDestinationLocation

Indica se o local de destino escolhido pelo usuário é retido durante a configuração de implantação do serviço.

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

-PinFileName

Indica se o nome do arquivo escolhido pelo usuário é retido durante a configuração de implantação do serviço.

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

-PinSourceLocation

Indica se o local de origem escolhido pelo usuário é retido durante a configuração de implantação do serviço.

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

-PinStorageDisk

Indica se o disco de armazenamento escolhido pelo usuário é retido durante a configuração de implantação do serviço.

Type:Boolean
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

-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

-SourceDisk

Especifica o disco rígido virtual de origem.

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

-StorageClassification

Especifica um objeto de classificação de armazenamento.

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

-StorageDisk

Especifica um disco em um host Hyper-V ou VMware ESX que uma máquina virtual nesse host pode usar em vez de usar um disco rígido virtual. Esse disco é chamado de disco de passagem. O termo VMware correspondente é RDM (Mapeamento bruto de dispositivo). O disco host é um disco rígido local ou uma unidade lógica em uma SAN (Rede de Área de Armazenamento). O VMM permite que a máquina virtual ignore o sistema de arquivos do host e acesse o disco de passagem diretamente. Os hosts Hyper-V dão suporte a discos de passagem e conversão de um disco de passagem para um VHD. Os hosts VMware ESX dão suporte a discos de passagem, mas não à conversão de disco. Os hosts Citrix XenServer não dão suporte a discos de passagem.

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

-StorageQoSPolicy

Especifica um objeto StorageQoSPolicy .

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

-VHDConfiguration

Especifica um objeto de configuração de disco rígido virtual.

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

Saídas

VirtualHardDiskConfiguration

Este cmdlet retorna um objeto VirtualHardDiskConfiguration .