Set-SCVMHost

Referentie

Module:: VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een host van een virtuele machine.

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

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 set-SCVMHost-cmdlet , worden als volgt samengevat:

Beschikbaarheid als host voor Virtual Machines

U kunt opgeven of een host momenteel wordt beschouwd door het VMM-plaatsingsproces als kandidaat waarop virtuele machines moeten worden geplaatst.

Instellingen voor hostreserve

U kunt de volgende instellingen voor hostreserves 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 gebruik 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 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 reserve-instellingen opgeeft, gebruikt VMM standaardinstellingen.

Paden naar virtuele machines

U kunt opgeven, als een set standaardpaden, locaties 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 maakt 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 inschakelt op een Hyper-V-host, 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 paden voor virtuele machines 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 $BMCRAA variabele.

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 te schakelen 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AttestationServerUrl

Hiermee geeft u de URL van de attestation-server.

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

-AvailableForPlacement

Geeft aan of het VMM-plaatsingsproces deze host of dit volume op een host in aanmerking komt 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 volume toch te implementeren. De standaardwaarde is $True. Deze parameter is niet van toepassing op VMware ESX-hosts.

Wanneer u deze parameter gebruikt met netwerkadapters, indien 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BaseDiskPaths

Hiermee geeft u de paden naar basisschijven.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 bijbehorende 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 gebruikt standaard een IP-adres of FQDN voor het 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 het aangepaste BMCProtocol.

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

-BMCProtocol

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

IPMI
SMASH
Aangepast telefoonnummer

Een BMC (ook wel bekend als een serviceprocessor of beheercontroller) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware fungeert. 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), is informatie over systeemhardware en de status van die systeemhardware beschikbaar.

Voorbeeldindeling: -BMCProtocol "Custom"

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

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

-BMCRunAsAccount

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

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

-BypassMaintenanceModeCheck

Geeft aan dat het 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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False