Compartilhar via

Set-SCVirtualHardDiskConfiguration

Módulo:
VirtualMachineManager Module

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

Sintaxe

Default (Padrão) 

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 do 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 do 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 armazenada no $VHDConfig para que o disco rígido virtual de origem armazenado no $VHD fixe 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 este parâmetro são:

  • Nenhum
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk

Propriedades do parâmetro

Tipo:DeploymentOption
Valor padrão:None
Valores aceitos:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DestinationLocation

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileInjectionDestinationLocation

Especifica o caminho da pasta de destino (caminho relativo à 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Int16
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileInjectionSourceLocation

Especifica o local (uma URL) do(s) arquivo(s) a ser injetado(s) 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FileName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ParentVirtualHardDiskDestinationPath

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ParentVirtualHardDiskPath

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PinDestinationLocation

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PinFileName

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PinSourceLocation

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PinStorageDisk

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourceDisk

Especifica o disco rígido virtual de origem.

Propriedades do parâmetro

Tipo:StandaloneVirtualHardDisk
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Propriedades do parâmetro

Tipo:StorageClassification
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 é Raw Device Mapping (RDM). O disco do host é um disco rígido local ou uma unidade lógica em uma rede de área de armazenamento (SAN). 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 dão suporte a discos de passagem e à conversão de um disco de passagem em um VHD. Os hosts VMware ESX oferecem suporte a discos de passagem, mas não à conversão de disco. Os hosts Citrix XenServer não oferecem suporte a discos de passagem.

Propriedades do parâmetro

Tipo:StorageDisk
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageQoSPolicy

Especifica um objeto StorageQoSPolicy .

Propriedades do parâmetro

Tipo:StorageQoSPolicy
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VHDConfiguration

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

Propriedades do parâmetro

Tipo:VirtualHardDiskConfiguration
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VirtualHardDiskConfiguration

Esse cmdlet retorna um objeto VirtualHardDiskConfiguration .