Set-SCVMHost

Referência

Módulo:: VirtualMachineManager

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

O cmdlet Set-SCVMHost modifica uma ou mais propriedades de um host de máquina virtual gerenciado pelo VMM (Virtual Machine Manager). As configurações que você pode modificar com o cmdlet Set-SCVMHost são resumidas da seguinte maneira:

Disponibilidade como host para Máquinas Virtuais

Você pode especificar se um host é atualmente considerado pelo processo de posicionamento do VMM como um candidato no qual colocar máquinas virtuais.

Configurações de Reserva de Host

Você pode definir as seguintes configurações de reserva de host:

Porcentagem do uso da CPU a ser reservada para uso pelo host.
Quantidade de espaço em disco (MB) a ser reservada para uso pelo host.
Número máximo de operações de E/S de disco por segundo (IOPS) a serem reservadas para uso pelo host.
Quantidade de memória (MB) a ser reservada para uso pelo host.
Porcentagem da capacidade de rede a ser reservada para uso pelo host.

O processo de posicionamento do VMM não recomenda colocar uma máquina virtual em um host, a menos que os requisitos de recursos da máquina virtual possam ser atendidos sem usar as reservas de host. Se você não especificar configurações de reserva, o VMM usará as configurações padrão.

Caminhos de máquinas virtuais

Você pode especificar, como um conjunto de caminhos padrão, locais em um host onde os arquivos de máquina virtual podem ser armazenados.

Credencial para gerenciar hosts em uma rede de perímetro ou domínio não confiável

Você pode especificar a senha de uma conta usada para gerenciar hosts Hyper-V localizados em uma rede de perímetro ou em um domínio não confiável.

Configurações de conexão remota

Você pode definir configurações de conexão remota para hosts Hyper-V (VMConnect) que permitem que os usuários se conectem a máquinas virtuais remotamente. Essa configuração não se aplica a máquinas virtuais em hosts VMware ESX.

Exemplos

Exemplo 1: disponibilizar um host para posicionamento

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

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando disponibiliza o VMHost01 como um host para máquinas virtuais. Definir o parâmetro AvailableForPlacement como True permite que o processo de posicionamento do VMM avalie esse host como um possível candidato no qual implantar máquinas virtuais.

Exemplo 2: habilitar conexões remotas em um host Hyper-V

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

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando habilita conexões remotas no VMHost01 e define a porta usada para conexões remotas como 5900.

Habilitar conexões remotas em um host Hyper-V permite que os usuários acessem remotamente e gerenciem suas máquinas virtuais no host.

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

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 obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

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

Exemplo 4: Atualizar as reservas de recursos para um host

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 obtém o objeto host 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 usuário e a senha do computador bare-metal para um 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

O primeiro comando obtém o objeto host chamado VMHost02 e armazena o objeto na variável $VMHost.

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

O terceiro comando atualiza o host armazenado em $VMHost com a nova conta Executar como armazenada no $BMCRAA.

O último comando atualiza o host armazenado em $VMHost usando sua interface fora de banda, que atualiza a conta Executar como para o host.

Exemplo 6: Atualizar os certificados para hosts XenServer em um 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 obtém o objeto host 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 usa o certificado fornecido em $Cert para permitir que o VMM se comunique com XenHost01 no modo seguro.

Parâmetros

-ApplyLatestCodeIntegrityPolicy

Indica que esse cmdlet faz com que o host atualize sua política HVCI usando o local do arquivo armazenado em CodeIntegrityPolicyPath.

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

-AttestationServerUrl

Especifica a 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 posicionamento do VMM considerará esse host ou esse volume em um host para ser qualificado como um possível local no qual implantar máquinas virtuais. Se esse parâmetro for definido como $False, você poderá optar por implantar máquinas virtuais nesse host ou volume de qualquer maneira. O valor padrão é $True. Esse parâmetro não se aplica aos hosts ESX do VMware.

Quando você usa esse parâmetro com adaptadores de rede, se definido como $False, o posicionamento não considera as redes lógicas configuradas neste adaptador de rede para determinar se o host é adequado para conectar 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 discos base.

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

-BMCAddress

Especifica ou atualiza o endereço BMC (controlador de gerenciamento de base) fora da banda para um computador físico específico. Pode ser um endereço IP, o FQDN (nome de domínio totalmente qualificado) ou o prefixo DNS (que geralmente é o mesmo nome que o nome NetBIOS).

Normalmente, o endereço BMC e sua conexão com a rede são separados do endereço IP associado a um adaptador de rede padrão. Como alternativa, alguns computadores usam 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 exclusiva e, portanto, é exclusivamente identificável na rede.

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

Observação: por padrão, o VMM usa um endereço IP ou FQDN para o BMCAddress. No entanto, também é possível criar um módulo Windows PowerShell que permite que você especifique outros tipos de endereços como o endereço BMC.

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

-BMCCustomConfigurationProvider

Especifica ou atualiza um objeto de provedor de configuração para um BMC (controlador de gerenciamento de quadro de base). Um provedor de configuração é um plug-in para o VMM que converte comandos do PowerShell do VMM para chamadas à API específicas para um tipo de BMC. Use esse 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 a porta BMC (controlador de gerenciamento de placa base) fora da banda para um computador físico específico. Uma porta BMC também é conhecida como uma porta do processador de serviço. As portas padrão de exemplo são 623 para IPMI e 443 para SMASH sobre WS-Man.

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

-BMCProtocol

Especifica ou atualiza o protocolo que o VMM usa para se comunicar com o BMC (controlador de gerenciamento de placa base fora de banda). Os valores válidos são:

IPMI
ESMAGAR
Personalizado

Um BMC (também conhecido como processador de serviço ou controlador de gerenciamento) é um controlador especializado na placa-mãe de um servidor que atua em uma interface entre o hardware e o software de gerenciamento do sistema. Se a placa-mãe de um computador físico incluir um BMC, quando o computador estiver conectado (se ele estiver desligado ou ligado e se um sistema operacional está instalado ou não), informações sobre o hardware do sistema e o estado dessa integridade de hardware do sistema estarão disponíveis.

Formato de exemplo: -BMCProtocol "Custom"

Observação: o protocolo Personalizado exige que você use 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 Executar como a ser usada com o dispositivo BMC (controlador de gerenciamento de quadro de base).

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 host mesmo que o host não esteja no modo de manutenção. Por padrão, a aplicação da política de integridade do código falhará se o host não estiver no 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 usada para restringir o software que pode ser executado no host.

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

-CPUPercentageReserve

Especifica o percentual de CPU a ser reservado para o uso do sistema operacional no computador host físico. Se você não usar esse parâmetro para especificar a reserva, a configuração padrão para o grupo de hosts será usada: 10%. O processo de posicionamento do VMM não recomendará que uma máquina virtual seja colocada em um host, a menos que seus requisitos de recursos possam ser atendidos sem o uso de reservas de host.

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