Partilhar via


Set-SCVirtualHardDiskConfiguration

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

Sintaxe

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 do 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 no $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 no $TierConfig e armazena o objeto na variável $VMConfig.

O quarto comando obtém a configuração do disco rígido virtual para a primeira configuração de máquina virtual armazenada no $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 do disco rígido virtual armazenado no $VHDConfig para que o disco rígido virtual de origem armazenado no $VHD fixe o valor do disco rígido virtual de origem, evitando assim que ele seja alterado durante o posicionamento.

Parâmetros

-DeploymentOption

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

  • Nenhum
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk
Tipo:DeploymentOption
Valores aceites:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DestinationLocation

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

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

-FileInjectionDestinationLocation

Especifica o caminho da pasta de destino (caminho relativo à raiz da partição) onde o(s) arquivo(s) de origem são(são) injetado(s) no VHD selecionado antes de ligar a máquina virtual pela primeira vez.

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

-FileInjectionDestinationPartition

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

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

-FileInjectionSourceLocation

Especifica o local (uma URL) do(s) arquivo(s) a ser injetado na máquina virtual antes de ligar a máquina virtual pela primeira vez.

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

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

-FileName

Especifica o nome do arquivo a ser usado quando você renomeia um arquivo de disco rígido virtual à medida que o adiciona a uma máquina virtual.

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

-ParentVirtualHardDiskDestinationPath

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

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

-ParentVirtualHardDiskPath

Especifica o caminho para o disco rígido virtual pai a ser usado ao criar um disco diferencial.

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

-PinDestinationLocation

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

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

-PinFileName

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

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

-PinSourceLocation

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

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

-PinStorageDisk

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

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

-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

-SourceDisk

Especifica o disco rígido virtual de origem.

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

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Tipo:StorageClassification
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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. Este disco é referido como um disco de passagem. O termo VMware correspondente é Raw Device Mapping (RDM). O disco host é um disco rígido local ou uma unidade lógica em uma SAN (Storage Area Network, rede de armazenamento de dados). O VMM permite que a máquina virtual ignore o sistema de arquivos do host e acesse o disco de passagem diretamente. Hyper-V hosts suportam discos de passagem e conversão de um disco de passagem em VHD. Os hosts VMware ESX suportam discos de passagem, mas não a conversão de disco. Os hosts Citrix XenServer não suportam discos de passagem.

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

-StorageQoSPolicy

Especifica um StorageQoSPolicy objeto.

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

-VHDConfiguration

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

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

Saídas

VirtualHardDiskConfiguration

Este cmdlet retorna um objeto VirtualHardDiskConfiguration.