Set-SCVMHost

Referentie

Module:: VirtualMachineManager

Wijzigt eigenschappen van een host van een virtuele machine.

Syntaxis

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

De cmdlet Set-SCVMHost wijzigt een of meer eigenschappen van een virtuele-machinehost die wordt beheerd door Virtual Machine Manager (VMM). Instellingen die u kunt wijzigen met de cmdlet Set-SCVMHost worden als volgt samengevat:

Beschikbaarheid als host voor virtuele machines

U kunt opgeven of een host momenteel door het VMM-plaatsingsproces wordt beschouwd als kandidaat voor het plaatsen van virtuele machines.

Instellingen voor hostreserve

U kunt de volgende hostreserve-instellingen configureren:

Percentage CPU-gebruik dat moet worden gereserveerd voor gebruik door de host.
Hoeveelheid schijfruimte (MB) die moet worden gereserveerd voor gebruik door de host.
Maximum aantal I/O-bewerkingen per seconde (IOPS) voor schijfgebruik door de host.
Hoeveelheid geheugen (MB) die moet worden gereserveerd voor gebruik door de host.
Percentage netwerkcapaciteit dat moet worden gereserveerd voor gebruik door de host.

Het VMM-plaatsingsproces raadt u niet aan om een virtuele machine op een host te plaatsen, tenzij aan de resourcevereisten van de virtuele machine kan worden voldaan zonder de hostreserves te gebruiken. Als u geen reserveinstellingen opgeeft, gebruikt VMM standaardinstellingen.

Paden voor virtuele machines

U kunt, als een set standaardpaden, locaties opgeven op een host waar bestanden van virtuele machines kunnen worden opgeslagen.

Referentie voor het beheren van hosts in een perimeternetwerk of niet-vertrouwd domein

U kunt het wachtwoord opgeven voor een account dat wordt gebruikt voor het beheren van Hyper-V hosts die zich in een perimeternetwerk of in een niet-vertrouwd domein bevinden.

Instellingen voor externe verbinding

U kunt instellingen voor externe verbindingen configureren voor Hyper-V hosts (VMConnect) waarmee gebruikers op afstand verbinding kunnen maken met virtuele machines. Deze instelling is niet van toepassing op virtuele machines op VMware ESX-hosts.

Voorbeelden

Voorbeeld 1: Een host beschikbaar maken voor plaatsing

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

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht wordt VMHost01 beschikbaar als host voor virtuele machines. Als u de parameter AvailableForPlacement instelt op True, kan het VMM-plaatsingsproces deze host evalueren als mogelijke kandidaat voor het implementeren van virtuele machines.

Voorbeeld 2: Externe verbindingen inschakelen op een Hyper-V-host

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

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht worden externe verbindingen op VMHost01 ingeschakeld en wordt de poort ingesteld die wordt gebruikt voor externe verbindingen met 5900.

Als u externe verbindingen op een Hyper-V host inschakelt, kunnen gebruikers hun virtuele machines op de host op afstand openen en beheren.

Voorbeeld 3: De paden voor virtuele machines voor een host bijwerken

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

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht wordt de eigenschap VMPaths bijgewerkt voor de host die is opgeslagen in $VMHost door het pad D:\VirtualMachinePath toe te voegen aan de lijst met virtuele-machinepaden op die host.

Voorbeeld 4: De resourcereserves voor een host bijwerken

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

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht worden de opgegeven eigenschappen voor VMHost01 bijgewerkt.

Voorbeeld 5: De gebruikersnaam en het wachtwoord van de bare-metalcomputer bijwerken voor een opgegeven fysieke host

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

Met de eerste opdracht wordt het hostobject met de naam VMHost02 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht wordt het Run As-accountobject met de naam BMCCreds opgehaald en wordt het object opgeslagen in de variabele $BMCRAA.

Met de derde opdracht wordt de host bijgewerkt die is opgeslagen in $VMHost met het nieuwe Uitvoeren als-account dat is opgeslagen in $BMCRAA.

Met de laatste opdracht wordt de host vernieuwd die is opgeslagen in $VMHost met behulp van de out-of-band-interface, waarmee het Uitvoeren als-account voor de host wordt bijgewerkt.

Voorbeeld 6: De certificaten voor XenServer-hosts in een cluster bijwerken

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

Met de eerste opdracht wordt het hostobject met de naam XenHost01 opgehaald en wordt het object opgeslagen in de $VMhost variabele.

De tweede haalt het certificaatobject voor XenHost01 op en slaat het object op in de $Certificate variabele.

De laatste opdracht maakt gebruik van het certificaat dat is opgegeven in $Cert om VMM in staat te stellen om te communiceren met XenHost01 in de beveiligde modus.

Parameters

-ApplyLatestCodeIntegrityPolicy

Geeft aan dat deze cmdlet ervoor zorgt dat de host het HVCI-beleid bijwerkt met behulp van de bestandslocatie die is opgeslagen in CodeIntegrityPolicyPath.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AttestationServerUrl

Hiermee geeft u de URL van de attestation-server.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AvailableForPlacement

Geeft aan of het VMM-plaatsingsproces deze host of dit volume op een host beschouwt als een mogelijke locatie waarop virtuele machines moeten worden geïmplementeerd. Als deze parameter is ingesteld op $False, kunt u ervoor kiezen om virtuele machines op deze host of dit volume toch te implementeren. De standaardwaarde is $True. Deze parameter is niet van toepassing op VMware ESX-hosts.

Wanneer u deze parameter met netwerkadapters gebruikt, als deze is ingesteld op $False, wordt bij plaatsing niet rekening gehouden met de logische netwerken die op deze netwerkadapter zijn geconfigureerd om te bepalen of de host geschikt is voor het verbinden van een virtuele machine.

Type:	Boolean
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BaseDiskPaths

Hiermee geeft u de paden naar basisschijven.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCAddress

Hiermee geeft u het out-of-band BMC-adres (Baseboard Management Controller) op voor een specifieke fysieke machine. Dit kan een IP-adres, de FQDN (Fully Qualified Domain Name) of het DNS-voorvoegsel zijn (meestal dezelfde naam als de NetBIOS-naam).

Normaal gesproken zijn het BMC-adres en de verbinding met het netwerk gescheiden van het IP-adres dat is gekoppeld aan een standaardnetwerkadapter. Sommige computers gebruiken ook een standaardnetwerkadapter om één adres voor de BMC en voor de netwerkadapter op te geven. Het BMC-adres heeft echter een unieke poort en is dus uniek identificeerbaar op het netwerk.

Voorbeeld van IPv4-indeling: -BMCAddress "10.0.0.21"
Voorbeeld van ipv6-indeling: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
Voorbeeld van FQDN-indeling: -BMCAddress "Computer01.Contoso.com"
Voorbeeld van NetBIOS-indeling: -BMCAddress "Computer01"

Opmerking: VMM maakt standaard gebruik van een IP-adres of FQDN voor de BMCAddress. Het is echter ook mogelijk om een Windows PowerShell-module te maken waarmee u andere typen adressen kunt opgeven als het BMC-adres.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCCustomConfigurationProvider

Hiermee geeft u een configuratieproviderobject op voor een BMC (Baseboard Management Controller). Een configuratieprovider is een invoegtoepassing voor VMM die VMM PowerShell-opdrachten vertaalt naar API-aanroepen die specifiek zijn voor een type BMC. Gebruik deze parameter met de custom BMCProtocol.

Type:	ConfigurationProvider
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCPort

Hiermee geeft u de out-of-band BMC-poort (Baseboard Management Controller) op voor een specifieke fysieke machine. Een BMC-poort wordt ook wel een serviceprocessorpoort genoemd. Voorbeeld van standaardpoorten zijn 623 voor IPMI en 443 voor SMASH via WS-Man.

Type:	UInt32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCProtocol

Hiermee geeft u het protocol op dat door VMM wordt gebruikt om te communiceren met de out-of-band baseboard management controller (BMC). Geldige waarden zijn:

IPMI
VERPLETTEREN
Gewoonte

Een BMC (ook wel een serviceprocessor of beheercontroller genoemd) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware uitvoert. Als het moederbord van een fysieke machine een BMC bevat, wanneer de machine is aangesloten (of deze is uitgeschakeld of ingeschakeld en of een besturingssysteem is geïnstalleerd), informatie over systeemhardware en de status van die systeemhardware beschikbaar is.

Voorbeeldindeling: -BMCProtocol "Custom"

Opmerking: Voor het aangepaste protocol moet u de parameter BMCCustomConfigurationProvider gebruiken.

Type:	OutOfBandManagementType
Geaccepteerde waarden:	None, IPMI, SMASH, Custom
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCRunAsAccount

Hiermee geeft u het Uitvoeren als-account dat moet worden gebruikt met het BMC-apparaat (Baseboard Management Controller).

Type:	RunAsAccount
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BypassMaintenanceModeCheck

Geeft aan dat code-integriteitsbeleid wordt toegepast op de host, zelfs als de host zich niet in de onderhoudsmodus bevindt. Standaard mislukt het toepassen van code-integriteitsbeleid als de host zich niet in de onderhoudsmodus bevindt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CodeIntegrityPolicy

Hiermee geeft u het code-integriteitsbeleid dat moet worden gebruikt om de software te beperken die op de host kan worden uitgevoerd.

Type:	CodeIntegrityPolicy
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CPUPercentageReserve

Hiermee geeft u het percentage CPU dat moet worden gereserveerd voor het gebruik van het besturingssysteem op de fysieke hostcomputer. Als u deze parameter niet gebruikt om de reserve op te geven, wordt de standaardinstelling voor de hostgroep gebruikt: 10 procent. Het VMM-plaatsingsproces raadt niet aan dat een virtuele machine op een host wordt geplaatst, tenzij aan de resourcevereisten kan worden voldaan zonder hostreserves te gebruiken.

Type:	UInt16
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False