New-SCVMHostProfile
Crea un perfil de host.
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
El cmdlet New-SCVMHostProfile crea un perfil de host. Los perfiles de host contienen las opciones de configuración de hardware y sistema operativo que se usan para implementar un equipo físico como host de Hyper-V.
Antes de crear un perfil de host, asegúrese de que el archivo de unidad de disco duro virtual (.vhd) que especifique existe en un recurso compartido de biblioteca.
Ejemplos
Ejemplo 1: Creación de un perfil de host
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
El primer comando obtiene el objeto de disco duro virtual denominado VHD01.vhd y almacena el objeto en la variable $VHD.
El segundo comando le pide las credenciales. En el símbolo del sistema, escriba las credenciales de una cuenta de administrador. El comando almacena las credenciales en la variable $Credential.
El tercer comando crea un perfil de host denominado HostProfile01 mediante el disco duro virtual almacenado en $VHD y las credenciales almacenadas en $Credential.
El último comando muestra información sobre el perfil de host recién creado al usuario.
Ejemplo 2: Clonación de un perfil de host existente
PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile
El primer comando obtiene el objeto de perfil de host denominado HostProfile01 y almacena el objeto en la variable $OrigHostProfile.
El segundo comando copia el perfil de host almacenado en $OrigHostProfile, le asigna el nombre especificado y almacena el nuevo objeto de perfil en la variable $NewHostProfile.
Ejemplo 3: Crear un perfil de host que incluya un perfil de adaptador de red de host
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
El primer comando obtiene el objeto de disco duro virtual denominado VHDX01.vhdx y almacena el objeto en la variable $VHDX.
El segundo comando obtiene el objeto de cuenta de ejecución denominado DomainJoinRAA y almacena el objeto en la variable $DomainJoinCreds.
El tercer comando solicita al usuario las credenciales de administrador local y almacena las credenciales proporcionadas en la variable $LocalAdminCreds.
El cuarto comando obtiene el objeto de perfil del adaptador de red host con el identificador de 259f47c7-c5a9-429d-a421-d232f9b34991 y almacena el objeto en la variable $HostNetAdapterProf.
El último comando crea un perfil de host denominado Perfil de host 03 mediante VHDX01 y el perfil del adaptador de red de host almacenado en $HostNetAdapterProf.
Parámetros
-AnswerFile
Especifica un objeto de script almacenado en la biblioteca de Virtual Machine Manager (VMM) que se usará como archivo de respuesta. El nombre del script del archivo de respuesta depende del sistema operativo que desea instalar en una máquina virtual:
- Sysprep.inf. Windows XP, Windows Server 2000 o Windows Server 2003
- Unattend.xml. Windows Vista, Windows 7 o Windows Server 2008
Type: | Script |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Baseline
Especifica una matriz de objetos Baseline .
Type: | Baseline[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BypassVHDConversion
Indica si un VHD dinámico asociado a un perfil de host no se convierte en un tipo fijo durante la implementación.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CodeIntegrityPolicy
Especifica una directiva de integridad de código.
Type: | CodeIntegrityPolicy |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerAccessRunAsAccount
Especifica la cuenta de ejecución de acceso al equipo que se usará para implementar el equipo. Esta cuenta de ejecución se agrega al equipo como administrador local y se usa para administrar la máquina.
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica una descripción para el perfil de host.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskConfiguration
Especifica la configuración de disco y partición para el equipo físico que se va a implementar con Windows Hyper-V.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Domain
Especifica un nombre de dominio completo (FQDN) para un dominio de Active Directory.
Formato de ejemplo: -Domain "Domain01.Corp.Contoso.com"
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainJoinRunAsAccount
Especifica una cuenta de ejecución que tiene permiso para unirse al dominio especificado.
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverMatchingTag
Especifica las etiquetas personalizadas que deben coincidir con las propiedades del controlador durante la implementación. Cuando se especifican etiquetas, el proceso de implementación coincide con las etiquetas especificadas en el perfil de host con las etiquetas de los controladores para descargar controladores coincidentes e instalarlas en la imagen de destino.
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 el nombre de la persona a cuyo nombre está registrada la máquina virtual.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GuiRunOnceCommands
Especifica una matriz de comandos que se van a agregar a la sección [GuiRunOnce] de un archivo de respuesta desatendido. Use comillas simples alrededor de cada cadena entre comillas dobles.
Formato de ejemplo: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'
Para obtener información sobre cómo Windows PowerShell usa comillas, escriba 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 el host debe ser un host protegido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JoinWorkgroup
Indica que esta operación se une a un grupo de trabajo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalAdministratorCredential
Especifica el nombre de usuario y la contraseña de la cuenta de administrador local (o la cuenta raíz de Linux en el caso de un perfil de sistema operativo invitado compatible con Linux).
Especificar credenciales en una plantilla nueva o existente, en un perfil de sistema operativo invitado nuevo o existente, o en una nueva máquina virtual invalida cualquier contraseña de administrador existente.
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de un objeto de VMM.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OrganizationName
Especifica el nombre de la organización para la persona en cuyo nombre está registrada una máquina virtual.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
Especifica el propietario de un objeto de VMM en forma de cuenta de usuario de dominio válida.
- Formato de ejemplo:
-Owner "Contoso\PattiFuller"
- Formato de ejemplo:
-Owner "PattiFuller@Contoso"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProductKey
Especifica una clave de producto. La clave de producto es un número de 25 dígitos que identifica la licencia del producto. Se puede usar una clave de producto para registrar VMM o un sistema operativo que se va a instalar en una máquina virtual o host.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeZone
Especifica un número (un índice) que identifica una región geográfica que comparte la misma hora estándar.
Para obtener una lista de índices de zona horaria, vea Valores de índice de zona horaria de Microsoft en .http://go.microsoft.com/fwlink/?LinkId=120935
Si no se especifica ninguna zona horaria, la zona horaria predeterminada que se usa para una máquina virtual es la misma configuración de zona horaria que se encuentra en el host de máquina virtual.
Formato de ejemplo para especificar la zona horaria estándar GMT: -TimeZone 085
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualHardDisk
Especifica un objeto de disco duro virtual.
Type: | VirtualHardDisk |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostNetworkAdapterProfile
Especifica un objeto de perfil de adaptador de red host.
Type: | PhysicalComputerNetworkAdapterProfile[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHostProfile
Especifica un objeto de perfil de host de máquina virtual.
Type: | PhysicalComputerProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMMServer
Especifica un objeto de servidor VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMPaths
Especifica el conjunto de rutas de acceso predeterminadas (como cadenas separadas por el operador de canalización) de un host en el que se pueden almacenar los archivos de máquina virtual.
Formato de ejemplo: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Salidas
HostProfile
Este cmdlet devuelve un objeto HostProfile .