Set-SCVMHost

Referência

Módulo:: VirtualMachineManager

Modifica as propriedades de um hospedeiro 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

O cmdlet Set-SCVMHost modifica uma ou mais propriedades de um hospedeiro de máquina virtual gerido pelo Virtual Machine Manager (VMM). As definições que pode modificar com o cmdlet Set-SCVMHost são resumidas da seguinte forma:

Disponibilidade como Anfitrião para Máquinas Virtuais

Pode especificar se um anfitrião é atualmente considerado pelo processo de colocação de VMM como um candidato para colocar máquinas virtuais.

Definições de reserva de anfitrião

Pode configurar as seguintes definições de reserva de anfitrião:

Percentagem de utilização do CPU para reservar para ser utilizado pelo hospedeiro.
Quantidade de espaço em disco (MB) para reservar para ser utilizado pelo anfitrião.
Número máximo de operações de E/S do disco por segundo (IOPS) para reservar para ser utilizado pelo anfitrião.
Quantidade de memória (MB) para reservar para ser utilizada pelo anfitrião.
Percentagem de capacidade de rede a reservar para utilização pelo hospedeiro.

O processo de colocação do VMM não recomendará a colocação de uma máquina virtual num hospedeiro, a menos que os requisitos de recursos da máquina virtual possam ser cumpridos sem utilizar as reservas de hospedeiro. Se não especificar as definições de reserva, o VMM utiliza as definições predefinições.

Caminhos de Máquina Virtual

Pode especificar, como um conjunto de caminhos predefinidos, localizações num anfitrião onde os ficheiros de máquinas virtuais podem ser armazenados.

Credencial para gerir anfitriões numa rede de perímetro ou domínio não confiável

Pode especificar a palavra-passe de uma conta utilizada para gerir os anfitriões Hiper-V que estão localizados numa rede de perímetro ou num domínio não confiável.

Definições de conexão remota

Pode configurar definições de ligação remota para anfitriões Hiper-V (VMConnect) que permitem aos utilizadores ligar-se remotamente a máquinas virtuais. Esta definição não se aplica a máquinas virtuais em anfitriões VMware ESX.

Exemplos

Exemplo 1: Disponibilizar um anfitrião para colocação

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

O primeiro comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando disponibiliza o VMHost01 como hospedeiro para máquinas virtuais. A definição do parâmetroAvailableForPlace para a True permite ao processo de colocação do VMM avaliar este hospedeiro como um possível candidato para implantar máquinas virtuais.

Exemplo 2: Ativar as ligações remotas num hospedeiro Hiper-V

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

O primeiro comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando permite ligações remotas em VMHost01 e define a porta utilizada para ligações remotas a 5900.

Permitir ligações remotas num anfitrião Hiper-V permite que os utilizadores acedam remotamente e gerem as suas máquinas virtuais no hospedeiro.

Exemplo 3: Atualizar os caminhos da máquina virtual para um hospedeiro

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

O primeiro comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando atualiza a propriedade VMPaths para o anfitrião armazenado em $VMHost adicionando o caminho D:\VirtualMachinePath à lista de caminhos de máquina virtual nesse hospedeiro.

Exemplo 4: Atualizar as reservas de recursos para um anfitrião

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

O primeiro comando recebe o objeto anfitrião chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando atualiza as propriedades especificadas para VMHost01.

Exemplo 5: Atualizar o nome de utilizador e a palavra-passe do computador de metal nu para um hospedeiro 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

O primeiro comando recebe o objeto anfitrião chamado VMHost02 e armazena o objeto na variável $VMHost.

O segundo comando obtém o objeto de conta Run As chamado BMCCreds e armazena o objeto na variável $BMCRAA.

O terceiro comando atualiza o anfitrião armazenado em $VMHost com a nova conta Run As armazenada em $BMCRAA.

O último comando atualiza o anfitrião armazenado em $VMHost utilizando a sua interface fora de banda, que atualiza a conta Run As para o anfitrião.

Exemplo 6: Atualizar os certificados para anfitriões XenServer num cluster

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

O primeiro comando recebe o objeto anfitrião chamado XenHost01 e armazena o objeto na variável $VMhost.

O segundo obtém o objeto de certificado para XenHost01 e armazena o objeto na variável $Certificate.

O último comando utiliza o certificado fornecido em $Cert para permitir que o VMM comunique com o XenHost01 em modo de segurança.

Parâmetros

-ApplyLatestCodeIntegrityPolicy

Indica que este cmdlet faz com que o anfitrião atualize a sua política de HVCI utilizando a localização do ficheiro armazenada no CodeIntegrityPolicyPath.

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

-AttestationServerUrl

Especifica o URL do servidor de atestado.

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

-AvailableForPlacement

Indica se o processo de colocação do VMM considerará este hospedeiro ou este volume num hospedeiro como uma possível localização para implantar máquinas virtuais. Se este parâmetro estiver definido para $False, pode optar por implementar máquinas virtuais neste hospedeiro ou volume de qualquer forma. O valor predefinido é $True. Este parâmetro não se aplica aos anfitriões VMware ESX.

Quando utilizar este parâmetro com adaptadores de rede, se estiver definido para $False, a colocação não considera as redes lógicas configuradas neste adaptador de rede para determinar se o hospedeiro é adequado para ligar uma máquina virtual.

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

-BaseDiskPaths

Especifica os caminhos para os discos base.

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

-BMCAddress

Especifica, ou atualizações, o endereço do controlador de gestão de base (BMC) fora da banda para uma máquina física específica. Este pode ser um endereço IP, o nome de domínio totalmente qualificado (FQDN), ou o prefixo DNS (que normalmente é o mesmo nome do nome NetBIOS).

Normalmente, o endereço BMC e a sua ligação à rede são separados do endereço IP associado a um adaptador de rede padrão. Em alternativa, alguns computadores utilizam um adaptador de rede padrão para fornecer um único endereço para o BMC e para o adaptador de rede. No entanto, o endereço BMC tem uma porta única e é, portanto, unicamente identificável na rede.

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

Nota: Por predefinição, o VMM utiliza um endereço IP ou FQDN para o BMCAddress. No entanto, também é possível criar um módulo Windows PowerShell que lhe permita especificar outros tipos de endereços como endereço BMC.

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

-BMCCustomConfigurationProvider

Especifica, ou atualizações, um objeto de fornecedor de configuração para um controlador de gestão de rodapé (BMC). Um fornecedor de configuração é um plug-in para VMM que traduz comandos VMM PowerShell para chamadas API que são específicos de um tipo de BMC. Utilize este parâmetro com o BMCProtocol personalizado.

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

-BMCPort

Especifica, ou atualizações, a porta de gestão de base (BMC) fora da banda para uma máquina física específica. Uma porta BMC também é conhecida como uma porta de processador de serviço. As portas por exemplo são 623 para IPMI e 443 para SMASH over WS-Man.

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

-BMCProtocol

Especifica, ou atualizações, o protocolo que o VMM utiliza para comunicar com o controlador de gestão de base fora de banda (BMC). Os valores válidos são:

IPMI
SMASH
Personalizado

Um BMC (também conhecido como processador de serviço ou controlador de gestão) é um controlador especializado na placa-mãe de um servidor que age uma interface entre o software de gestão de hardware e sistema. Se a placa-mãe de uma máquina física incluir um BMC, quando a máquina está ligada (se está ligada ou ligada, e se um sistema operativo está ou não instalado), estão disponíveis informações sobre hardware do sistema e sobre o estado da saúde do hardware do sistema.

Formato de exemplo: -BMCProtocol "Custom"

Nota: O protocolo Personalizado requer que utilize o 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 a conta Run As para utilizar com o dispositivo de gestão de rodapé (BMC).

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

-BypassMaintenanceModeCheck

Indica que a política de Integridade do Código é aplicada ao hospedeiro mesmo que o hospedeiro não esteja em modo de manutenção. Por predefinição, a aplicação da política de Integridade do Código falha se o hospedeiro não estiver em modo de manutenção.

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

-CodeIntegrityPolicy

Especifica a política de Integridade do Código a ser utilizada para restringir o software que pode ser executado no hospedeiro.

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

-CPUPercentageReserve

Especifica a percentagem de CPU para reservar para a utilização do sistema operativo no computador de anfitrião físico. Se não utilizar este parâmetro para especificar a reserva, utiliza-se a definição predefinida para o grupo anfitrião: 10%. O processo de colocação do VMM não recomendará que uma máquina virtual seja colocada num hospedeiro, a menos que os seus requisitos de recursos possam ser cumpridos sem utilizar reservas hospedeiras.

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