Compartir a través de

Set-SCVMHostProfile

  • Referencia
Módulo:
VirtualMachineManager

Modifica las propiedades de un perfil de host.

Sintaxis

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-Description <String>]
   [-Owner <String>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-AnswerFile <Script>]
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVMHostProfile modifica las propiedades de un perfil de host.

Para obtener información sobre cómo crear un perfil de host, escriba Get-Help New-SCVMHostProfile -Detailed.

Ejemplos

Ejemplo 1: Establecimiento del valor de zona horaria para un perfil de host especificado

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Este comando obtiene el objeto de perfil de host denominado HostProfile01 y establece su valor de zona horaria en la zona horaria este de EE. UU. (035).

Ejemplo 2: Agregar un perfil de adaptador de red host a un perfil de host

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

El primer comando obtiene el objeto de perfil de host denominado HostProfile01 y almacena el objeto en la variable $VMHostProfile.

El segundo 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 agrega el perfil del adaptador de red host almacenado en $HostNetAdapterProf a HostProfile01.

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

-Baseline

Especifica una matriz de objetos Baseline.

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

-BypassVHDConversion

Indica si un disco duro virtual dinámico asociado a un perfil de host no se convierte en un tipo fijo durante la implementación.

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

-CodeIntegrityPolicy

Especifica una directiva de integridad de código.

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

-ComputerAccessRunAsAccount

Especifica la cuenta de ejecución de acceso al equipo que se va a usar para implementar el equipo. Esta cuenta de ejecución se agregará al equipo como administrador local y se usará para administrar la máquina.

Tipo:RunAsAccount
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 host.

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

-DiskConfiguration

Especifica la configuración de disco y partición del equipo físico que se va a implementar con Windows Hyper-V.

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

-DomainJoinRunAsAccount

Especifica una cuenta de ejecución que tiene permiso para unirse al dominio especificado.

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

Tipo:System.Collections.Generic.List`1[System.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

-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

-IsGuarded

Indica que el host debe ser un host protegido.

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

Tipo:Guid
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

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

-RemoveAnswerFile

Indica que esta operación quita el archivo de respuesta del perfil de host.

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

-RemoveGuiRunOnceCommands

Indiates que esta operación quita la propiedad Run Once Commands de la GUI de un perfil de host.

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

-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

-VirtualHardDisk

Especifica un objeto de disco duro virtual.

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

-VMHostNetworkAdapterProfile

Especifica una matriz de objetos de perfil del adaptador de red host.

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

-VMHostProfile

Especifica un objeto de perfil de host de máquina virtual.

Tipo:PhysicalComputerProfile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-VMPaths

Especifica un conjunto de rutas de acceso predeterminadas (como cadenas separadas por el operador de canalización) en un host donde se pueden almacenar los archivos de máquina virtual.

Formato de ejemplo: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Salidas

HostProfile[]

Este cmdlet devuelve uno o varios objetos HostProfile.