Compartir a través de


New-SCGuestOSProfile

Crea un perfil de sistema operativo invitado para su uso en VMM.

Sintaxis

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.

Un perfil de sistema operativo invitado almacena información de configuración del sistema operativo. Un perfil consta de un conjunto de propiedades que contienen la configuración más común especificada en un archivo de respuesta desatendido (por ejemplo, sysprep.inf o un archivo de Unattend.xml).

Puede crear un perfil de sistema operativo invitado independiente o personalizar una plantilla o una máquina virtual para incluir la configuración del perfil del sistema operativo invitado. 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 función de un perfil de sistema operativo invitado existente, o bien puede personalizar la configuración a medida que cree 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 Run As account 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 de 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 el 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

Cautela

En este artículo se hace referencia a CentOS, una distribución de Linux que ha alcanzado el estado Fin de vida (EOL). Tenga en cuenta su uso y planeación en consecuencia. Para obtener más información, consulte la guía de fin de vida de CentOS de .

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 VMM que se va a usar como archivo de respuesta. El nombre del script de 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
Tipo:Script
Alias:SysPrepFile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-AutoLogonCount

Especifica el número de veces que Windows debería registrar automáticamente el administrador especificado en el archivo de respuesta en la sesión de consola.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:RunAsAccount
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputerName

Especifica el nombre de un equipo que VMM puede identificar de forma única en la red. Los valores aceptables para este parámetro son:

  • FQDN
  • Dirección IPv4 o IPv6
  • Nombre netBIOS
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción para el perfil de sistema operativo invitado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableAutoLogon

Indica que este cmdlet deshabilita el inicio de sesión de administrador automático.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Domain

Especifica un nombre de dominio completo (FQDN) para un dominio de Active Directory.

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

Tipo:String
Alias:JoinDomain
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:VMMCredential
Alias:JoinDomainCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DomainJoinOrganizationalUnit

Especifica la unidad organizativa a la que se une el equipo durante una minicons setup desatendida.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FullName

Especifica el nombre de la persona en cuyo nombre está registrada una máquina virtual.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GuestOSProfile

Especifica un objeto de perfil de sistema operativo invitado.

Tipo:GuestOSProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LinuxAdministratorSSHKey

Especifica el archivo de clave pública para una clave SSH de Linux.

Tipo:SSHKey
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LinuxAdministratorSSHKeyString

Especifica una clave SSH de administrador de Linux como una cadena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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"

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:VMMCredential
Alias:AdminPasswordCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto VMM.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:OperatingSystem
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OrganizationName

Especifica el nombre de la organización para la persona en cuyo nombre está registrada una máquina virtual.

Tipo:String
Alias:OrgName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Owner

Especifica el propietario de un objeto VMM en forma de una cuenta de usuario de dominio válida.

  • Formato de ejemplo: -Owner "Contoso\PattiFuller"
  • Formato de ejemplo: -Owner "PattiFuller@Contoso"
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveDomainJoinOrganizationalUnit

Indica que este cmdlet quita la unidad organizativa unida al equipo durante la instalación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoveServerFeatures

Indica que este cmdlet quita todos los roles y características de servidor de una plantilla.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Shielded

Indica si el objeto está protegido.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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, consulte de 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 la máquina virtual.

Formato de ejemplo para especificar la zona horaria estándar GMT: -TimeZone 085

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UnattendSettings

Especifica un par clave-valor que consta de cadena, cadena.

Tipo:System.Collections.Generic.Dictionary`2[System.String,System.String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserRole

Especifica un objeto de rol de usuario.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 en un perfil de sistema operativo invitado.

Tipo:String
Alias:JoinWorkgroup
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

GuestOSProfile

Este cmdlet devuelve un objeto GuestOSProfile.