Partilhar via

Set-SCVMHostProfile

  • Referência
Módulo:
VirtualMachineManager

Modifica as propriedades de um perfil de host.

Sintaxe

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-Description <String>]
   [-Owner <String>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-AnswerFile <Script>]
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMHostProfile modifica as propriedades de um perfil de host.

Para obter informações sobre como criar um perfil de host, digite Get-Help New-SCVMHostProfile -Detailed.

Exemplos

Exemplo 1: Definir o valor de fuso horário para um perfil de host especificado

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Este comando obtém o objeto de perfil de host chamado HostProfile01 e define seu valor de fuso horário para o fuso horário Leste dos EUA (035).

Exemplo 2: Adicionar um perfil de adaptador de rede de host a um perfil de host

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

O primeiro comando obtém o objeto de perfil de host chamado HostProfile01 e armazena o objeto na variável $VMHostProfile.

O segundo comando obtém o objeto de perfil do adaptador de rede host com a ID de 259f47c7-c5a9-429d-a421-d232f9b34991 e armazena o objeto na variável $HostNetAdapterProf.

O último comando adiciona o perfil do adaptador de rede host armazenado em $HostNetAdapterProf a HostProfile01.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca do VMM para usar como um arquivo de resposta. O nome do script do arquivo de resposta depende do sistema operacional que você deseja instalar em uma máquina virtual:

  • Sysprep.inf. Windows XP, Windows Server 2000 ou Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 ou Windows Server 2008
Tipo:Script
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Baseline

Especifica uma matriz de objetos Linha de Base.

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

-BypassVHDConversion

Indica se um VHD dinâmico anexado a um perfil de host não é convertido em um tipo fixo durante a implantação.

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

-CodeIntegrityPolicy

Especifica uma política de integridade de código.

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

-ComputerAccessRunAsAccount

Especifica a conta de acesso ao computador Run As a ser usada para implantar o computador. Essa conta Run As será adicionada à máquina como um administrador local e usada para gerenciar a máquina.

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

-Description

Especifica uma descrição para o perfil de host.

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

-DiskConfiguration

Especifica a configuração de disco e partição para o computador físico a ser implantado com o Windows Hyper-V.

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

-Domain

Especifica um nome de domínio totalmente qualificado (FQDN) para um domínio do Ative Directory.

Exemplo de formato: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

Especifica uma conta Run As que tem permissão para ingressar no domínio especificado.

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

-DriverMatchingTag

Especifica as tags personalizadas a serem correspondidas às propriedades do driver durante a implantação. Quando as tags são especificadas, o processo de implantação faz a correspondência entre as tags especificadas no perfil do host e as tags nos drivers para baixar os drivers correspondentes e instalá-los na imagem de destino.

Tipo:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FullName

Especifica o nome da pessoa em cujo nome uma máquina virtual está registrada.

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

-GuiRunOnceCommands

Especifica uma matriz de comandos a serem adicionados à seção [GuiRunOnce] de um arquivo de resposta autônomo. Use aspas simples ao redor de cada cadeia de caracteres entre aspas duplas.

Exemplo de formato: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Para obter informações sobre como o Windows PowerShell usa aspas, digite Get-Help about_Quoting_Rules.

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

-IsGuarded

Indica que o host precisa ser um host protegido.

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

-JobGroup

Especifica uma ID para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui a mesma ID do grupo de trabalhos.

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

-LocalAdministratorCredential

Especifica o nome de usuário e a senha para a conta de Administrador Local (ou conta raiz do Linux no caso de um perfil de Sistema Operacional Convidado compatível com Linux).

A especificação de credenciais em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente ou em uma nova máquina virtual substitui qualquer senha de Administrador existente.

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

-Name

Especifica o nome de um objeto do VMM.

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

-OrganizationName

Especifica o nome da organização para a pessoa em cujo nome uma máquina virtual está registrada.

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

-Owner

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

  • Exemplo de formato: -Owner "Contoso\PattiFuller"
  • Exemplo de formato: -Owner "PattiFuller@Contoso"
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 de produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

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

-RemoveAnswerFile

Indica que essa operação remove o arquivo de resposta do perfil de host.

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

-RemoveGuiRunOnceCommands

Indica que esta operação remove a propriedade GUI Run Once Commands de um perfil de host.

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

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que compartilha a mesma hora padrão. Para obter uma lista de índices de fuso horário, consulte Microsoft Time Zone Index Values em http://go.microsoft.com/fwlink/?LinkId=120935. Se nenhum fuso horário for especificado, o fuso horário padrão usado para uma máquina virtual será a mesma configuração de fuso horário que está no host da máquina virtual.

Exemplo de formato para especificar o fuso horário padrão GMT: -TimeZone 085

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

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

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

-VMHostNetworkAdapterProfile

Especifica uma matriz de objetos de perfil do adaptador de rede do host.

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

-VMHostProfile

Especifica um objeto de perfil de host de máquina virtual.

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

-VMMServer

Especifica um objeto de servidor VMM.

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

-VMPaths

Especifica um conjunto de caminhos padrão (como cadeias de caracteres separadas pelo operador de pipeline) em um host onde os arquivos de máquina virtual podem ser armazenados.

Exemplo de formato: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Saídas

HostProfile[]

Este cmdlet retorna um ou mais objetos HostProfile.