Compartilhar via

Set-SCVirtualHardDisk

Módulo:
VirtualMachineManager Module

Altera as propriedades de um objeto de disco rígido virtual usado no VMM.

Sintaxe

Default 

Set-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-OperatingSystem <OperatingSystem>]
    [-VirtualizationPlatform <VirtualizationPlatform>]
    [-Tag <System.Collections.Generic.List`1[System.String]>]
    [-ProductKey <String>]
    [-UserRole <UserRole>]
    [-Enabled <Boolean>]
    [-VMMServer <ServerConnection>]
    [-JobGroup <Guid>]
    [-Name <String>]
    [-SharePath <String>]
    [-Description <String>]
    [-Owner <String>]
    [-FamilyName <String>]
    [-Release <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

EquivalencySet 

Set-SCVirtualHardDisk
    [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Set-SCVirtualHardDisk altera uma ou mais propriedades de um objeto de disco rígido virtual usado em um ambiente do Virtual Machine Manager (VMM). Um arquivo de disco rígido virtual usado no VMM é um arquivo .vhd baseado no Windows, um arquivo .vhd baseado no Citrix XenServer ou um arquivo .vmdk baseado no VMware.

As propriedades que você pode alterar incluem:

  • Descrição
  • Ativado
  • Nome
  • Sistema Operacional
  • Proprietário
  • Caminho do compartilhamento

Um arquivo de disco rígido virtual pode ser armazenado na biblioteca do VMM ou pode ser anexado a uma unidade de disco virtual em uma máquina virtual ou modelo.

Para alterar as configurações de barramento e LUN de uma unidade de disco virtual, use 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.vhd" da biblioteca no 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 no $VHD para "VHD de inicialização mais recente do Windows Server 2008 R2".

Exemplo 2: Habilitar 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 no $VMDK.

Exemplo 3: Especificar 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"

Esse comando obtém todos os objetos de disco rígido virtual da biblioteca do VMM cujo proprietário é "Desconhecido" e, em seguida, 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.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Enabled

Habilita um objeto quando definido como $True ou desabilita um objeto quando definido como $False. Por exemplo, se você quiser atualizar o software em um modelo de máquina virtual, poderá desabilitar o objeto de modelo na biblioteca do VMM para impedir temporariamente que os usuários usem esse objeto.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-FamilyName

Especifica um nome de família para um recurso físico na biblioteca do VMM. Esse valor é usado em conjunto com Release, Namespace e Type para estabelecer a equivalência entre os recursos da biblioteca.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Default
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

-Name

Especifica o nome de um objeto do VMM.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-OperatingSystem

Especifica o tipo de sistema operacional para uma máquina virtual. Para listar os nomes de todos os sistemas operacionais disponíveis no VMM, digite Get-SCOperatingSystem.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ProductKey

Especifica uma chave do produto. A chave do produto é um número de 25 dígitos que identifica a licença do produto. Uma chave do produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Default
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

-Release

Especifica uma cadeia de caracteres que descreve a versão de um recurso de biblioteca. O VMM cria automaticamente um valor de versão para cada recurso importado para a biblioteca. Depois que o recurso for importado, a cadeia de caracteres poderá ser personalizada.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Default
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

-SharePath

Especifica um caminho para um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção Universal de Nomenclatura).

Formato de exemplo: -SharePath "\\LibServer01\LibShare"

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Tag

Especifica uma palavra ou frase a ser associada a um objeto para que você possa pesquisar todos os objetos com o conjunto especificado de tags. Você pode pesquisar um subconjunto de tags ou pode pesquisar o conjunto completo de tags.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[System.String]

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

Conjuntos de parâmetros

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

-UserRole

Especifica um objeto de função de usuário.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Default
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualHardDisks

Especifica uma matriz de objetos de disco rígido virtual.

Propriedades do parâmetro

Tipo:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]

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

Conjuntos de parâmetros

EquivalencySet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VirtualizationPlatform

Especifica a plataforma de virtualização de um host de máquina virtual gerenciado pelo VMM. Os valores aceitáveis para este parâmetro são:

  • HyperV
  • VMwareESX
  • XENServer

Propriedades do parâmetro

Tipo:VirtualizationPlatform
Valor padrão:None
Valores aceitos:Unknown, VirtualServer, HyperV, VMwareVC, VMwareESX, XENServer
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
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

VirtualHardDisk

Esse cmdlet retorna um objeto VirtualHardDisk .

Observações

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