New-SCVMHostProfile

Cria um perfil de hospedeiro.

Syntax

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

Description

O cmdlet New-SCVMHostProfile cria um perfil de anfitrião. Os perfis do anfitrião contêm as definições de configuração do hardware e do sistema operativo utilizadas para implantar um computador físico como anfitrião Hiper-V.

Antes de criar um perfil de anfitrião, certifique-se de que o ficheiro de disco rígido virtual (.vhd) que especifica existe numa partilha da biblioteca.

Exemplos

Exemplo 1: Criar um perfil de anfitrião

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfile

O primeiro comando recebe o objeto de disco rígido virtual chamado VHD01.vhd e armazena o objeto na variável $VHD.

O segundo comando pede-lhe credenciais. A pedido, insira as credenciais de uma conta administrador. O comando armazena as credenciais na variável $Credential.

O terceiro comando cria um perfil de anfitrião chamado HostProfile01 utilizando o disco rígido virtual armazenado em $VHD, e as credenciais armazenadas em $Credential.

O último comando mostra informações sobre o perfil de anfitrião recém-criado para o utilizador.

Exemplo 2: Clonar um perfil de hospedeiro existente

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

O primeiro comando obtém o objeto de perfil do anfitrião chamado HostProfile01 e armazena o objeto na variável $OrigHostProfile.

O segundo comando copia o perfil do anfitrião armazenado em $OrigHostProfile, dá-lhe o nome especificado e armazena o novo objeto de perfil na variável $NewHostProfile.

Exemplo 3: Criar um perfil de anfitrião que inclua um perfil adaptador de rede anfitrião

PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProf

O primeiro comando recebe o objeto de disco rígido virtual chamado VHDX01.vhdx e armazena o objeto na variável $VHDX.

O segundo comando obtém o objeto de conta Run As chamado DomainJoinRAA e armazena o objeto na variável $DomainJoinCreds.

O terceiro comando solicita ao utilizador credenciais de administrador local e armazena as credenciais fornecidas na variável $LocalAdminCreds.

O quarto 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 cria um perfil de anfitrião chamado Host Profile 03 utilizando o VHDX01 e o perfil adaptador de rede do anfitrião armazenado em $HostNetAdapterProf.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca Virtual Machine Manager (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 é adicionada à máquina como administrador local e usada 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:True
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:True
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 identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador 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

-JoinWorkgroup

Indica que esta operação se junta a um grupo de trabalho.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto VMM.

Type:String
Position:0
Default value:None
Required:True
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

-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:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostNetworkAdapterProfile

Especifica um objeto de perfil adaptador de rede de anfitrião.

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 objeto HostProfile .