Set-SCVMConfiguration

  • Referencia
Módulo:
VirtualMachineManager

Modifica la configuración de la máquina virtual para un nivel de equipo.

Sintaxis

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVMConfiguration modifica la configuración de la máquina virtual para un nivel de equipo. La configuración de la máquina virtual describe cómo se configurará la máquina virtual cuando se implemente el servicio.

Ejemplos

Ejemplo 1: Actualización de la configuración de la máquina virtual de un nivel de máquina antes de implementar el servicio

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

El primer comando obtiene el objeto de configuración de servicio denominado Service01 y almacena el objeto en la variable $ServiceConfig.

El segundo comando obtiene la configuración del nivel de equipo para la configuración del servicio almacenada en $ServiceConfig y almacena el objeto en la variable $TierConfig.

El tercer comando obtiene la configuración de la máquina virtual para la configuración del nivel de equipo almacenada en $TierConfig y almacena la variable en la variable $VMConfig.

El último comando establece la propiedad description del primer objeto de configuración de máquina virtual almacenado en $VMConfig y muestra las propiedades de la configuración de la máquina virtual al usuario.

Ejemplo 2: Configuración del objeto de configuración de máquina virtual para un nivel de máquina para anclar el host de una máquina virtual

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

El primer comando obtiene el objeto de configuración de servicio denominado Service01 y almacena el objeto en la variable $ServiceConfig.

El segundo comando obtiene el objeto de configuración de nivel de equipo para la configuración del servicio almacenada en $ServiceConfig y almacena el objeto en la variable $TierConfig.

El tercer comando obtiene los objetos de configuración de la máquina virtual para la configuración del nivel de equipo almacenada en $TierConfig y almacena los objetos en la variable $VMConfig.

El último comando establece la propiedad PinVMHost en $True para el primer objeto de configuración de máquina virtual almacenado en $VMConfig. Por lo tanto, cuando se implementa el servicio, no se cambiará el host de la máquina virtual creada con esta configuración.

Ejemplo 3: Configuración del objeto de configuración de máquina virtual para un servicio en una nube privada

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

El primer comando obtiene el objeto de configuración de servicio denominado Service01 y almacena el objeto en la variable $ServiceConfig.

El segundo comando obtiene la configuración del nivel de equipo para la configuración del servicio almacenada en $ServiceConfig y almacena el objeto en la variable $TierConfig.

El tercer comando obtiene los objetos de configuración de la máquina virtual para la configuración del nivel de equipo almacenada en $TierConfig y almacena los objetos en la variable $VMConfig.

El cuarto comando obtiene el objeto de nube privada denominado Production y almacena el objeto en la variable $Cloud.

El último comando actualiza la descripción del segundo objeto de configuración de máquina virtual almacenado en $VMConfig para la nube privada almacenada en $Cloud.

Parámetros

-AvailabilitySetNames

Especifica una lista de nombres de conjuntos de disponibilidad.

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

-CapabilityProfile

Especifica un objeto de perfil de funcionalidad.

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

-Cloud

Especifica un objeto de nube privada.

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

-ComputerName

Especifica el nombre de un equipo que Virtual Machine Manager (VMM) puede identificar de forma única en la red. Los formatos válidos 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

-CostCenter

Especifica el centro de costos de una máquina virtual para que pueda recopilar datos sobre la asignación de máquinas virtuales (o recursos asignados a máquinas virtuales) para usar en el sistema de facturación.

Tipo:String
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 la configuración.

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

-Name

Especifica el nombre de un objeto VMM.

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

-NoConnectedHost

Quita el host de una configuración de máquina virtual.

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

-OnBehalfOfUser

Especifica el nombre de un usuario. Este cmdlet establece el en nombre del usuario como el usuario que especifica este parámetro.

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

-OnBehalfOfUserRole

Especifica un rol de usuario. Este cmdlet establece el rol en nombre del usuario como rol de usuario que especifica este parámetro. Para obtener un objeto de rol de usuario, use el cmdlet Get-SCUserRole.

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

-PinVMHost

Indica si el host de máquina virtual elegido por el usuario se conserva durante la configuración de implementación del servicio.

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

-PinVMLocation

Indica si la ubicación de la máquina virtual elegida por el usuario se conserva durante la configuración de implementación del servicio.

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

-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

-Tag

Especifica una palabra o frase que se va a asociar a un objeto para que pueda buscar todos los objetos con el conjunto de etiquetas especificado. Puede buscar un subconjunto de etiquetas o puede buscar el conjunto completo de etiquetas.

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

-VMConfiguration

Especifica un objeto de configuración de máquina virtual.

Tipo:BaseVMConfiguration
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMHost

Especifica un objeto host de máquina virtual. VMM admite hosts de Hyper-V, hosts de VMware ESX y hosts de Citrix XenServer.

Para obtener más información sobre cada tipo de host, consulte el cmdlet Add-SCVMHost.

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

-VMHostGroup

Especifica un objeto de grupo host de máquina virtual o una matriz de objetos de grupo host.

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

-VMLocation

Especifica la ruta de acceso a 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

-VMMServer

Especifica un objeto de servidor VMM.

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

Salidas

VMConfiguration

Este cmdlet devuelve un objeto VMConfiguration .