Set-SCGuestOSProfile

Módulo:

VirtualMachineManager

Cambia las propiedades de un perfil de sistema operativo invitado usado en VMM.

Syntax

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-SCGuestOSProfile cambia una o varias propiedades de un perfil de sistema operativo invitado usado en un entorno de Virtual Machine Manager (VMM). Los cambios realizados en un perfil del sistema operativo invitado afectan únicamente al perfil del sistema operativo invitado. Los cambios no afectan a las máquinas virtuales existentes que se crearon anteriormente mediante este perfil.

Ejemplos

Ejemplo 1: Especificar un nombre de organización para un perfil de sistema operativo invitado existente

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

El primer comando obtiene el objeto de perfil del sistema operativo invitado denominado NewOSProfile01 y almacena el objeto en la variable $OSProfile.

El segundo comando establece Contoso como el nombre de la organización para el perfil de sistema operativo invitado almacenado en $OSProfile.

Ejemplo 2: Especificación de sshKey para un perfil de sistema operativo invitado linux existente

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

El primer comando obtiene el objeto de perfil del so invitado denominado MyCentOSProfile y almacena el objeto en la variable $OSProfile.

El segundo comando obtiene el objeto SSHKey denominado My.Sshkey y almacena el objeto en la variable $Sshkey.

El último comando establece el objeto My.sshkey en el perfil de sistema operativo invitado almacenado en $OSProfile.

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 debería 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

Deshabilita el inicio de sesión automático del administrador.

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 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:	0
Default value:	None
Required:	True
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 va a 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:	Named
Default value:	None
Required:	False
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 rendimiento y optimización de recursos (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 unida al equipo 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 de servidor y las características 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 al shell de comandos inmediatamente.

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 usada 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 que consta de 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

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

Notas

• Requiere un objeto de perfil de so invitado de VMM, que se puede recuperar mediante el cmdlet Get-SCGuestOSProfile .

Vínculos relacionados

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile