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