Set-SCVMConfiguration

  • Referencia
Módulo:
VirtualMachineManager

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

Syntax

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 para 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 la 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 el propety de 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 la 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.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

Especifica un objeto de perfil de funcionalidad.

Type:CapabilityProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Cloud

Especifica un objeto de nube privada.

Type:Cloud
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 de NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica una descripción para la configuración.

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

-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

-NoConnectedHost

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

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

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-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

-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 buscar el conjunto completo de etiquetas.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConfiguration

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

Type:BaseVMConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMHostGroup

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

Type:HostGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMLocation

Especifica la ruta de acceso a una máquina virtual.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica un objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Salidas

VMConfiguration

Este cmdlet devuelve un objeto VMConfiguration .