Set-SCVMHost

Referencia

Módulo:: VirtualMachineManager

Modifica las propiedades de un host de máquina virtual.

Syntax

Set-SCVMHost
   [-VMHost] <Host>
   [-BMCAddress <String>]
   [-BMCRunAsAccount <RunAsAccount>]
   [-BMCPort <UInt32>]
   [-BMCProtocol <OutOfBandManagementType>]
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-ManagementAdapterMACAddress <String>]
   [-SMBiosGuid <Guid>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-ApplyLatestCodeIntegrityPolicy]
   [-BypassMaintenanceModeCheck]
   [-MaintenanceHost <Boolean>]
   [-AvailableForPlacement <Boolean>]
   [-Description <String>]
   [-OverrideHostGroupReserves <Boolean>]
   [-CPUPercentageReserve <UInt16>]
   [-NetworkPercentageReserve <UInt16>]
   [-DiskSpaceReserveMB <UInt64>]
   [-MaxDiskIOReservation <UInt64>]
   [-MemoryReserveMB <UInt64>]
   [-VMPaths <String>]
   [-BaseDiskPaths <String>]
   [-RemoteConnectEnabled <Boolean>]
   [-RemoteConnectPort <UInt32>]
   [-SecureRemoteConnectEnabled <Boolean>]
   [-RemoteConnectCertificatePath <String>]
   [-RemoveRemoteConnectCertificate]
   [-EnableLiveMigration <Boolean>]
   [-LiveMigrationMaximum <UInt32>]
   [-LiveStorageMigrationMaximum <UInt32>]
   [-UseAnyMigrationSubnet <Boolean>]
   [-MigrationSubnet <String[]>]
   [-MigrationAuthProtocol <MigrationAuthProtocolType>]
   [-MigrationPerformanceOption <MigrationPerformanceOptionType>]
   [-VMHostManagementCredential <VMMCredential>]
   [-NumaSpanningEnabled <Boolean>]
   [-FibreChannelWorldWidePortNameMinimum <String>]
   [-FibreChannelWorldWidePortNameMaximum <String>]
   [-FibreChannelWorldWideNodeName <String>]
   [-IsDedicatedToNetworkVirtualizationGateway <Boolean>]
   [-JobGroup <Guid>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVMHost modifica una o varias propiedades de un host de máquina virtual administrado por Virtual Machine Manager (VMM). La configuración que puede modificar con el cmdlet Set-SCVMHost se resume de la siguiente manera:

Disponibilidad como host para Virtual Machines

Puede especificar si el proceso de selección de ubicación de VMM considera actualmente un host como candidato para colocar máquinas virtuales.

Configuración de reserva de host

Puede establecer los siguientes valores de configuración de reserva de host:

Porcentaje de uso de CPU que se va a reservar para su uso por parte del host.
Cantidad de espacio en disco (MB) que se va a reservar para su uso por parte del host.
Número máximo de operaciones de E/S de disco por segundo (IOPS) que se van a reservar para su uso por parte del host.
Cantidad de memoria (MB) que se va a reservar para su uso por parte del host.
Porcentaje de capacidad de red que se va a reservar para su uso por parte del host.

El proceso de selección de ubicación de VMM no recomienda colocar una máquina virtual en un host a menos que se puedan cumplir los requisitos de recursos de la máquina virtual sin usar las reservas del host. Si no especifica la configuración de reserva, VMM usa la configuración predeterminada.

Rutas de acceso a máquinas virtuales

Se puede especificar, como un conjunto de rutas de acceso predeterminadas, las ubicaciones de un host donde se pueden almacenar los archivos de máquina virtual.

Credenciales para administrar hosts en una red perimetral o un dominio que no es de confianza

Puede especificar la contraseña de una cuenta que se usa para administrar hosts de Hyper-V que se encuentran en una red perimetral o en un dominio que no es de confianza.

Configuración de conexión remota

Puede configurar las opciones de conexión remota para hosts de Hyper-V (VMConnect) que permiten a los usuarios conectarse a máquinas virtuales de forma remota. Esta configuración no es aplicable a máquinas virtuales en hosts de VMware ESX.

Ejemplos

Ejemplo 1: Hacer que un host esté disponible para la selección de ubicación

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -AvailableForPlacement $True

El primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El segundo comando hace que VMHost01 esté disponible como host para las máquinas virtuales. Al establecer el parámetro AvailableForPlacement en True, el proceso de selección de ubicación de VMM permite evaluar este host como posible candidato en el que implementar máquinas virtuales.

Ejemplo 2: Habilitación de conexiones remotas en un host de Hyper-V

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -RemoteConnectEnabled $True -RemoteConnectPort 5900

El primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El segundo comando habilita las conexiones remotas en VMHost01 y establece el puerto usado para las conexiones remotas en 5900.

Habilitar conexiones remotas en un host de Hyper-V permite a los usuarios acceder de forma remota y administrar sus máquinas virtuales en el host.

Ejemplo 3: Actualización de las rutas de acceso de la máquina virtual para un host

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -VMPaths "C:\ProgramData\Microsoft\Windows\Hyper-V|D:\VirtualMachinePath"

El primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El segundo comando actualiza la propiedad VMPaths para el host almacenado en $VMHost agregando la ruta de acceso D:\VirtualMachinePath a la lista de rutas de acceso de máquina virtual en ese host.

Ejemplo 4: Actualización de las reservas de recursos para un host

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Set-SCVMHost -VMHost $VMHost -CPUPercentageReserve 40 -DiskSpaceReserveMB 2048 -MaxDiskIOReservation 500 -MemoryReserveMB 1024 -NetworkPercentageReserve 40

El primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.

El segundo comando actualiza las propiedades especificadas para VMHost01.

Ejemplo 5: Actualización del nombre de usuario y la contraseña del equipo sin sistema operativo para un host físico especificado

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCCreds"
PS C:\> Set-SCVMHost $VMHost -BMCRunAsAccount $BMCRAA
PS C:\> Read-SCVMHost -VMHost $VMHost -RefreshOutOfBandProperties

El primer comando obtiene el objeto host denominado VMHost02 y almacena el objeto en la variable $VMHost.

El segundo comando obtiene el objeto de cuenta de ejecución denominado BMCCreds y almacena el objeto en la variable $BMCRAA.

El tercer comando actualiza el host almacenado en $VMHost con la nueva cuenta de ejecución almacenada en $BMCRAA.

El último comando actualiza el host almacenado en $VMHost mediante su interfaz fuera de banda, que actualiza la cuenta de ejecución del host.

Ejemplo 6: Actualización de los certificados para los hosts de XenServer en un clúster

PS C:\> $VMHost = Get-VMHost -ComputerName "XenHost01" 
PS C:\> $Cert = Get-SCCertificate -Computername $VMHost.Name 
PS C:\> Set-SCVMHost -VMHost $VMHost -Certificate $Cert -EnableSecureMode $True

El primer comando obtiene el objeto host denominado XenHost01 y almacena el objeto en la variable $VMhost.

El segundo obtiene el objeto de certificado para XenHost01 y almacena el objeto en la variable $Certificate.

El último comando usa el certificado proporcionado en $Cert para permitir que VMM se comunique con XenHost01 en modo seguro.

Parámetros

-ApplyLatestCodeIntegrityPolicy

Indica que este cmdlet hace que el host actualice su directiva de HVCI mediante la ubicación del archivo almacenada en CodeIntegrityPolicyPath.

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

-AttestationServerUrl

Especifica la dirección URL del servidor de atestación.

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

-AvailableForPlacement

Indica si el proceso de selección de ubicación de VMM considerará este host o este volumen en un host para que sea apto como una posible ubicación en la que implementar máquinas virtuales. Si este parámetro se establece en $False, puede optar por implementar máquinas virtuales en este host o volumen de todos modos. El valor predeterminado es $True. Este parámetro no se aplica a los hosts de VMware ESX.

Cuando se usa este parámetro con adaptadores de red, si se establece en $False, la selección de ubicación no tiene en cuenta las redes lógicas configuradas en este adaptador de red para determinar si el host es adecuado para conectar una máquina virtual.

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

-BaseDiskPaths

Especifica las rutas de acceso a los discos base.

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

-BMCAddress

Especifica, o actualiza, la dirección del controlador de administración de placa base (BMC) fuera de banda para una máquina física específica. Puede ser una dirección IP, el nombre de dominio completo (FQDN) o el prefijo DNS (que suele ser el mismo nombre que el nombre netBIOS).

Normalmente, la dirección BMC y su conexión a la red son independientes de la dirección IP asociada a un adaptador de red estándar. Como alternativa, algunos equipos usan un adaptador de red estándar para proporcionar una sola dirección para el BMC y para el adaptador de red. Sin embargo, la dirección BMC tiene un puerto único y, por tanto, es identificable de forma única en la red.

Formato IPv4 de ejemplo: -BMCAddress "10.0.0.21"
Formato Ipv6 de ejemplo: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
Formato FQDN de ejemplo: -BMCAddress "Computer01.Contoso.com"
Ejemplo de formato NetBIOS: -BMCAddress "Computer01"

Nota: De forma predeterminada, VMM usa una dirección IP o un FQDN para BMCAddress. Sin embargo, también es posible crear un módulo de Windows PowerShell que le permita especificar otros tipos de direcciones como dirección BMC.

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

-BMCCustomConfigurationProvider

Especifica, o actualiza, un objeto de proveedor de configuración para un controlador de administración de placa base (BMC). Un proveedor de configuración es un complemento de VMM que traduce comandos de PowerShell de VMM a llamadas API específicas de un tipo de BMC. Use este parámetro con el BMCProtocol personalizado.

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

-BMCPort

Especifica, o actualiza, el puerto del controlador de administración de placa base fuera de banda (BMC) para una máquina física específica. Un puerto BMC también se conoce como puerto de procesador de servicios. Los puertos predeterminados de ejemplo son 623 para IPMI y 443 para SMASH a través de WS-Man.

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

-BMCProtocol

Especifica, o actualiza, el protocolo que VMM usa para comunicarse con el controlador de administración de placa base fuera de banda (BMC). Los valores válidos son:

IPMI
APLASTAR
Personalizado

Un BMC (también conocido como procesador de servicios o controlador de administración) es un controlador especializado en la placa base de un servidor que actúa como una interfaz entre el hardware y el software de administración del sistema. Si la placa base de una máquina física incluye un BMC, cuando la máquina está conectada (ya sea apagada o encendida, y si está instalado o no un sistema operativo), información sobre el hardware del sistema y el estado de ese estado de hardware del sistema está disponible.

Formato de ejemplo: -BMCProtocol "Custom"

Nota: El protocolo personalizado requiere que use el parámetro BMCCustomConfigurationProvider .

Type:	OutOfBandManagementType
Accepted values:	None, IPMI, SMASH, Custom
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCRunAsAccount

Especifica la cuenta de ejecución que se va a usar con el dispositivo de controlador de administración de placa base (BMC).

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

-BypassMaintenanceModeCheck

Indica que la directiva de integridad de código se aplica al host incluso si el host no está en modo de mantenimiento. De forma predeterminada, se produce un error en la aplicación de la directiva de integridad de código si el host no está en modo de mantenimiento.

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

-CodeIntegrityPolicy

Especifica la directiva de integridad de código que se va a usar para restringir el software que se puede ejecutar en el host.

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

-CPUPercentageReserve

Especifica el porcentaje de CPU que se va a reservar para el uso del sistema operativo en el equipo host físico. Si no usa este parámetro para especificar la reserva, se usará la configuración predeterminada para el grupo host: 10%. El proceso de selección de ubicación de VMM no recomienda colocar una máquina virtual en un host a menos que se puedan cumplir sus requisitos de recursos sin usar reservas de host.

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