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 .