Partilhar via


Set-SCVMHostProfile

Modifica as propriedades de um perfil de host.

Sintaxe

Default (Predefinição)

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

Propriedades dos parâmetros

Tipo:Script
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Baseline

Especifica uma matriz de objetos Baseline .

Propriedades dos parâmetros

Tipo:

Baseline[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CodeIntegrityPolicy

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

Propriedades dos parâmetros

Tipo:CodeIntegrityPolicy
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:RunAsAccount
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Description

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DiskConfiguration

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DomainJoinRunAsAccount

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

Propriedades dos parâmetros

Tipo:RunAsAccount
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:

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

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FullName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-IsGuarded

Indica que o host precisa ser um host protegido.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:VMMCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OrganizationName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RemoveAnswerFile

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RemoveGuiRunOnceCommands

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Propriedades dos parâmetros

Tipo:VirtualHardDisk
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMHostNetworkAdapterProfile

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

Propriedades dos parâmetros

Tipo:

PhysicalComputerNetworkAdapterProfile[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMHostProfile

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

Propriedades dos parâmetros

Tipo:PhysicalComputerProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

Tipo:ServerConnection
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

HostProfile

Este cmdlet retorna um ou mais objetos HostProfile .