New-SCGuestOSProfile
Crea un perfil de sistema operativo invitado para su uso en VMM.
Syntax
New-SCGuestOSProfile
[-Shielded <Boolean>]
[-GuiRunOnceCommands <String[]>]
[-MergeAnswerFile <Boolean>]
[-AnswerFile <Script>]
[-OperatingSystem <OperatingSystem>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-FullName <String>]
[-OrganizationName <String>]
[-ComputerName <String>]
[-ProductKey <String>]
[-LocalAdministratorCredential <VMMCredential>]
[-TimeZone <Int32>]
[-RemoveServerFeatures]
[-GuestOSProfile <GuestOSProfile>]
[-Owner <String>]
[-UserRole <UserRole>]
[-AutoLogonCredential <RunAsAccount>]
[-AutoLogonCount <UInt32>]
[-DisableAutoLogon]
[-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-DomainJoinOrganizationalUnit <String>]
[-RemoveDomainJoinOrganizationalUnit]
[-LinuxDomainName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCGuestOSProfile
[-Shielded <Boolean>]
[-GuiRunOnceCommands <String[]>]
[-MergeAnswerFile <Boolean>]
[-AnswerFile <Script>]
[-OperatingSystem <OperatingSystem>]
[-LinuxAdministratorSSHKey <SSHKey>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-FullName <String>]
[-OrganizationName <String>]
[-ComputerName <String>]
[-ProductKey <String>]
[-LocalAdministratorCredential <VMMCredential>]
[-TimeZone <Int32>]
[-RemoveServerFeatures]
[-GuestOSProfile <GuestOSProfile>]
[-Owner <String>]
[-UserRole <UserRole>]
[-AutoLogonCredential <RunAsAccount>]
[-AutoLogonCount <UInt32>]
[-DisableAutoLogon]
[-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-DomainJoinOrganizationalUnit <String>]
[-RemoveDomainJoinOrganizationalUnit]
[-LinuxDomainName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCGuestOSProfile
[-Shielded <Boolean>]
[-GuiRunOnceCommands <String[]>]
[-MergeAnswerFile <Boolean>]
[-AnswerFile <Script>]
[-OperatingSystem <OperatingSystem>]
[-LinuxAdministratorSSHKeyString <String>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-FullName <String>]
[-OrganizationName <String>]
[-ComputerName <String>]
[-ProductKey <String>]
[-LocalAdministratorCredential <VMMCredential>]
[-TimeZone <Int32>]
[-RemoveServerFeatures]
[-GuestOSProfile <GuestOSProfile>]
[-Owner <String>]
[-UserRole <UserRole>]
[-AutoLogonCredential <RunAsAccount>]
[-AutoLogonCount <UInt32>]
[-DisableAutoLogon]
[-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-DomainJoinOrganizationalUnit <String>]
[-RemoveDomainJoinOrganizationalUnit]
[-LinuxDomainName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCGuestOSProfile
[-Shielded <Boolean>]
[-GuiRunOnceCommands <String[]>]
[-MergeAnswerFile <Boolean>]
[-AnswerFile <Script>]
[-OperatingSystem <OperatingSystem>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-FullName <String>]
[-OrganizationName <String>]
[-ComputerName <String>]
[-ProductKey <String>]
[-LocalAdministratorCredential <VMMCredential>]
[-TimeZone <Int32>]
[-RemoveServerFeatures]
-Domain <String>
[-DeploymentTypeNano <Boolean>]
[-DomainJoinCredential <VMMCredential>]
[-GuestOSProfile <GuestOSProfile>]
[-Owner <String>]
[-UserRole <UserRole>]
[-AutoLogonCredential <RunAsAccount>]
[-AutoLogonCount <UInt32>]
[-DisableAutoLogon]
[-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-DomainJoinOrganizationalUnit <String>]
[-RemoveDomainJoinOrganizationalUnit]
[-LinuxDomainName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
New-SCGuestOSProfile
[-Shielded <Boolean>]
[-GuiRunOnceCommands <String[]>]
[-MergeAnswerFile <Boolean>]
[-AnswerFile <Script>]
[-OperatingSystem <OperatingSystem>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[-Description <String>]
[-FullName <String>]
[-OrganizationName <String>]
[-ComputerName <String>]
[-ProductKey <String>]
[-LocalAdministratorCredential <VMMCredential>]
[-TimeZone <Int32>]
[-RemoveServerFeatures]
[-Workgroup <String>]
[-GuestOSProfile <GuestOSProfile>]
[-Owner <String>]
[-UserRole <UserRole>]
[-AutoLogonCredential <RunAsAccount>]
[-AutoLogonCount <UInt32>]
[-DisableAutoLogon]
[-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-DomainJoinOrganizationalUnit <String>]
[-RemoveDomainJoinOrganizationalUnit]
[-LinuxDomainName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
El cmdlet New-SCGuestOSProfile crea un perfil de sistema operativo invitado para su uso en Virtual Machine Manager (VMM). Un sistema operativo invitado es el sistema operativo de una máquina virtual, a diferencia de un sistema operativo host que se encuentra en el equipo host físico en el que se implementan una o varias máquinas virtuales.
El perfil del sistema operativo invitado almacena la información de configuración del sistema operativo. Un perfil consiste en un conjunto de propiedades que contienen la configuración más común especificada en un archivo de respuesta para instalación desatendida (como un archivo Sysprep.inf o Unattend.xml).
Puede crear un perfil de sistema operativo invitado independiente o personalizar una plantilla o una máquina virtual para que incluya la configuración del perfil de sistema operativo. El cmdlet New-SCGuestOSProfile almacena el nuevo objeto de perfil de sistema operativo invitado en la biblioteca VMM.
Puede crear un perfil de sistema operativo invitado basado en la configuración predeterminada, en un perfil de sistema operativo invitado existente, o bien, puede personalizar la configuración al crear el perfil. Si no especifica ningún parámetro excepto el parámetro Name, el cmdlet New-SCGuestOSProfile crea un objeto de perfil de sistema operativo invitado predeterminado.
Ejemplos
Ejemplo 1: Crear un perfil de sistema operativo invitado predeterminado
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS
El primer comando obtiene el objeto de sistema operativo denominado "edición de 64 bits de Windows Server 2008 R2 Enterprise" de VMMServer01 y almacena el objeto en la variable $OS.
El segundo comando crea un perfil de sistema operativo invitado predeterminado denominado NewProfile01 y especifica el nombre del sistema operativo.
Ejemplo 2: Creación de un perfil de sistema operativo invitado que se usará para unir una máquina virtual a un dominio
PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS
El primer comando obtiene el objeto de cuenta de ejecución denominado RunAsAccount01 y almacena el objeto en la variable $DomainCredential.
El segundo comando obtiene el objeto de sistema operativo denominado edición de 64 bits de Windows Server 2008 R2 Enterprise de VMMServer01 y almacena el objeto en la variable $OS.
El último comando crea un perfil de sistema operativo invitado denominado NewOSProfile02 y especifica el nombre del sistema operativo. Cuando se usa NewOSProfile02 para crear una máquina virtual, el perfil usa la cuenta de ejecución especificada para unir la máquina virtual al dominio de Contoso.com.
Nota: Si proporciona un objeto PSCredential en lugar de una cuenta de ejecución para el parámetro DomainJoinCredential , se recomienda usar solo una cuenta con derechos limitados para unir automáticamente una máquina virtual a un dominio porque el nombre de la cuenta de dominio y la contraseña aparecen brevemente en texto sin formato en el servidor host.
Ejemplo 3: Clonación de un perfil de sistema operativo invitado existente
PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS
El primer comando obtiene el objeto de perfil del sistema operativo invitado denominado NewOSProfile02 y almacena el objeto en la variable $OSProfile.
El segundo comando obtiene el objeto del sistema operativo denominado edición de 64 bits de Windows Server 2008 R2 Datacenter y almacena el objeto en la variable $OS.
El último comando crea un perfil de sistema operativo invitado denominado NewOSProfile03, que se basa en NewOSProfile02, pero modifica el nombre del equipo y especifica un nombre diferente para el sistema operativo. Todas las demás configuraciones de NewOSProfile03 son idénticas a las de NewOSProfile02.
Ejemplo 4: Creación de un perfil de sistema operativo invitado linux y establecimiento del nombre de dominio DNS de Linux
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"}
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os
El primer comando obtiene el objeto de sistema operativo denominado CentOS Linux 6 (64 bits) de VMMServer01 y almacena el objeto en la variable $OS.
El segundo comando crea un perfil de sistema operativo invitado denominado My CentOS Profile y especifica el nombre del sistema operativo y el nombre de dominio DNS de Linux. Cuando se usa el perfil de My CentOS para crear una máquina virtual, el perfil usa el nombre de dominio DNS de Linux especificado.
Parámetros
-AnswerFile
Especifica un objeto de script almacenado en la biblioteca Virtual Machine Manager 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 |
Aliases: | SysPrepFile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AutoLogonCount
Especifica el número de veces que Windows debe registrar automáticamente al administrador especificado en el archivo de respuesta en la sesión de consola.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoLogonCredential
Especifica la cuenta de ejecución contenida en el archivo de respuesta que Windows usa para iniciar sesión en la sesión de consola cuando se habilita el inicio de sesión de administrador automático.
Type: | RunAsAccount |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Especifica el nombre de un equipo que VMM puede identificar de forma única en su red. Los valores permitidos para este parámetro son los siguientes:
- FQDN
- Dirección IPv4 o IPv6
- Nombre de NetBIOS
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentTypeNano
{{Fill DeploymentTypeNano Description}}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica una descripción para el perfil del sistema operativo invitado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutoLogon
Indica que este cmdlet deshabilita el inicio de sesión de administrador automático.
Type: | SwitchParameter |
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 |
Aliases: | JoinDomain |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainJoinCredential
Especifica el nombre de usuario y la contraseña de una cuenta que tiene permiso para unir un equipo al dominio. Se recomienda usar una cuenta de derechos limitada que une equipos al dominio. Esto incluye equipos virtuales y físicos.
Puede usar el parámetro actual para especificar credenciales en un vmHostProfile para unir un equipo host físico al dominio, o para 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, para unir una máquina virtual al dominio.
Type: | VMMCredential |
Aliases: | JoinDomainCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainJoinOrganizationalUnit
Especifica la unidad organizativa a la que se une el equipo durante una minicons setup desatendida.
Type: | 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 |
-GuestOSProfile
Especifica un objeto del perfil de sistema operativo invitado.
Type: | GuestOSProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
-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 |
-LinuxAdministratorSSHKey
Especifica el archivo de clave pública para una clave SSH de Linux.
Type: | SSHKey |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinuxAdministratorSSHKeyString
Especifica una clave SSH de administrador de Linux como una cadena.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinuxDomainName
Especifica un nombre de dominio completo (FQDN) que se usará junto con la especialización del sistema operativo Linux.
Formato de ejemplo: -LinuxDomainName "Domain01.Corp.Contoso.com"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Aliases: | AdminPasswordCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MergeAnswerFile
Indica si este cmdlet combina el archivo de respuesta junto con la configuración del sistema operativo invitado. El valor predeterminado es $True. La consola VMM usa este parámetro. No especifique este parámetro.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-OperatingSystem
Especifica el tipo de sistema operativo de una máquina virtual.
Para obtener los nombres de todos los sistemas operativos disponibles en VMM, escriba Get-SCOperatingSystem
.
Type: | OperatingSystem |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Aliases: | OrgName |
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 |
-RemoveDomainJoinOrganizationalUnit
Indica que este cmdlet quita la unidad organizativa que el equipo unido durante la instalación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveServerFeatures
Indica que este cmdlet quita todos los roles y características de servidor de una plantilla.
Type: | SwitchParameter |
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 |
-Shielded
Indica si el objeto está blindado.
Type: | Boolean |
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 |
-UnattendSettings
Especifica un par clave-valor formado por String, String.
Type: | System.Collections.Generic.Dictionary`2[System.String,System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRole
Especifica un objeto de función de usuario.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 |
-Workgroup
Especifica en una plantilla nueva o existente, en un perfil de sistema operativo invitado nuevo o existente, o en una nueva máquina virtual el nombre del grupo de trabajo al que desea unirse a una máquina virtual. Puede usar este parámetro para invalidar el valor existente en una plantilla o un perfil del sistema operativo invitado.
Type: | String |
Aliases: | JoinWorkgroup |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Salidas
GuestOSProfile
Este cmdlet devuelve un objeto GuestOSProfile .