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