Partilhar via

Set-SCVMHostProfile

  • Referência
Módulo:
VirtualMachineManager

Modifica as propriedades de um perfil de anfitrião.

Syntax

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 anfitrião.

Para obter informações sobre como criar um perfil de anfitrião, escreva Get-Help New-SCVMHostProfile -Detailed.

Exemplos

Exemplo 1: Definir o valor do fuso horário para um perfil de anfitrião especificado

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

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

Exemplo 2: Adicionar um perfil adaptador de rede de anfitrião a um perfil de anfitrião

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 do anfitrião chamado HostProfile01 e armazena o objeto na variável $VMHostProfile.

O segundo comando obtém o objeto de perfil do adaptador de rede de anfitrião com o 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 de anfitriões armazenado em $HostNetAdapterProf ao HostProfile01.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca VMM para usar como ficheiro de resposta. O nome do script do ficheiro de resposta depende do sistema operativo que pretende instalar numa máquina virtual:

  • Sysprep.inf. Windows XP, Windows Server 2000 ou Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 ou Windows Server 2008
Type:Script
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

Especifica uma matriz de objetos de base .

Type:Baseline[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BypassVHDConversion

Indica se um VHD dinâmico ligado a um perfil de hospedeiro não é convertido para um tipo fixo durante a implantação.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CodeIntegrityPolicy

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

Type:CodeIntegrityPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerAccessRunAsAccount

Especifica o acesso ao computador Executar Como conta a utilizar para implantar o computador. Esta conta Run As será adicionada à máquina como administrador local e utilizada para gerir a máquina.

Type:RunAsAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição para o perfil do anfitrião.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskConfiguration

Especifica a configuração do disco e partição para o computador físico que deve ser implantado com o Hiper-V do Windows.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Domain

Especifica um nome de domínio totalmente qualificado (FQDN) para um domínio ative directory.

Formato de exemplo: -Domain "Domain01.Corp.Contoso.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinRunAsAccount

Especifica uma conta Run As que tem permissão para se juntar ao domínio especificado.

Type:RunAsAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DriverMatchingTag

Especifica as etiquetas personalizadas para combinar com as propriedades do condutor durante a implantação. Quando as etiquetas são especificadas, o processo de implantação corresponde às etiquetas especificadas no perfil do anfitrião com as etiquetas nos controladores, a fim de descarregar os controladores correspondentes e instalá-los na imagem-alvo.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GuiRunOnceCommands

Especifica um conjunto de comandos para adicionar à secção [GuiRunOnce] de um ficheiro de resposta não acompanhado. Utilize aspas únicas em torno de cada corda incluída em aspas duplas.

Formato de exemplo: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Para obter informações sobre como Windows PowerShell utiliza aspas, escreva Get-Help about_Quoting_Rules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsGuarded

Indica que o hospedeiro precisa de ser um hospedeiro protegido.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalAdministratorCredential

Especifica o nome de utilizador e a palavra-passe para a conta de Administrador Local (ou conta raiz Linux no caso de um perfil do Sistema Operativo de Hóspedes compatível com Linux).

Especificar credenciais num modelo novo ou existente, num perfil de sistema operativo de hóspedes novo ou existente, ou numa nova máquina virtual substitui qualquer palavra-passe do Administrador existente.

Type:VMMCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto VMM.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OrganizationName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

Especifica o proprietário de um objeto do VMM sob a forma de uma conta de utilizador de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Especifica uma chave de 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 registar VMM ou um sistema operativo para ser instalado numa máquina virtual ou hospedeiro.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAnswerFile

Indica que esta operação remove o ficheiro de resposta do perfil do anfitrião.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveGuiRunOnceCommands

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que partilha o mesmo tempo normal. Para obter uma lista de índices de fuso horário, consulte os valores do índice do fuso horário da Microsoft em http://go.microsoft.com/fwlink/?LinkId=120935. Se não for especificado um fuso horário, o fuso horário padrão utilizado para uma máquina virtual é a mesma definição de fuso horário que está no hospedeiro da máquina virtual.

Formato de exemplo para especificar o fuso horário padrão GMT: -TimeZone 085

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualHardDisk

Especifica um objeto de disco rígido virtual.

Type:VirtualHardDisk
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostNetworkAdapterProfile

Especifica uma matriz de objetos de perfil adaptador de rede de anfitriões.

Type:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostProfile

Especifica um objeto de perfil de anfitrião de máquina virtual.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMPaths

Especifica um conjunto de caminhos predefinidos (como cordas separadas pelo operador do oleoduto) num hospedeiro onde os ficheiros de máquinas virtuais podem ser armazenados.

Formato de exemplo: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

HostProfile[]

Este cmdlet devolve um ou mais objetos HostProfile .