Set-SCVMHost

Referenz

Modul:: VirtualMachineManager

Ändert die Eigenschaften eines Virtuellen Computerhosts.

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>]

Beschreibung

Das Cmdlet Set-SCVMHost ändert eine oder mehrere Eigenschaften eines virtuellen Computerhosts, der vom Virtual Machine Manager (VMM) verwaltet wird. Einstellungen, die Sie mit dem cmdlet Set-SCVMHost ändern können, werden wie folgt zusammengefasst:

Verfügbarkeit als Host für virtuelle Computer

Sie können angeben, ob ein Host derzeit vom VMM-Platzierungsprozess als Kandidat betrachtet wird, auf dem virtuelle Computer platziert werden sollen.

Hostreserveeinstellungen

Sie können die folgenden Hostreserveeinstellungen konfigurieren:

Prozentsatz der CPU-Auslastung, die für die Verwendung durch den Host reserviert werden soll.
Speicherplatz (MB), der für die Verwendung durch den Host reserviert werden soll.
Maximale Anzahl von Datenträger-E/A-Vorgängen pro Sekunde (IOPS), die für die Verwendung durch den Host reserviert werden sollen.
Arbeitsspeicher (MB), der für die Verwendung durch den Host reserviert werden soll.
Prozentsatz der Netzwerkkapazität, die für die Nutzung durch den Host reserviert werden soll.

Der VMM-Platzierungsprozess wird nicht empfohlen, einen virtuellen Computer auf einem Host zu platzieren, es sei denn, die Ressourcenanforderungen des virtuellen Computers können erfüllt werden, ohne die Hostreserven zu verwenden. Wenn Sie keine Reserveeinstellungen angeben, verwendet VMM Standardeinstellungen.

Pfade für virtuelle Computer

Sie können als Eine Reihe von Standardpfaden Speicherorte auf einem Host angeben, an dem Dateien des virtuellen Computers gespeichert werden können.

Anmeldeinformationen zum Verwalten von Hosts in einem Umkreisnetzwerk oder einer nicht vertrauenswürdigen Domäne

Sie können das Kennwort für ein Konto angeben, das zum Verwalten von Hyper-V Hosts verwendet wird, die sich in einem Umkreisnetzwerk oder in einer nicht vertrauenswürdigen Domäne befinden.

Remoteverbindungseinstellungen

Sie können Remoteverbindungseinstellungen für Hyper-V Hosts (VMConnect) konfigurieren, mit denen Benutzer remote eine Verbindung mit virtuellen Computern herstellen können. Diese Einstellung gilt nicht für virtuelle Computer auf VMware ESX-Hosts.

Beispiele

Beispiel 1: Bereitstellung eines Hosts für die Platzierung

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

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl stellt VMHost01 als Host für virtuelle Computer zur Verfügung. Wenn Sie den Parameter "AvailableForPlacement" auf "True" festlegen, kann der VMM-Platzierungsprozess diesen Host als möglichen Kandidaten auswerten, auf dem virtuelle Computer bereitgestellt werden sollen.

Beispiel 2: Aktivieren von Remoteverbindungen auf einem Hyper-V-Host

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

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl aktiviert Remoteverbindungen auf VMHost01 und legt den Port fest, der für Remoteverbindungen auf 5900 verwendet wird.

Wenn Remoteverbindungen auf einem Hyper-V-Host aktiviert werden, können Benutzer remote auf ihre virtuellen Computer auf dem Host zugreifen und diese verwalten.

Beispiel 3: Aktualisieren der Pfade des virtuellen Computers für einen Host

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

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl aktualisiert die VMPaths-Eigenschaft für den in $VMHost gespeicherten Host, indem der Pfad "D:\VirtualMachinePath" zur Liste der Pfade des virtuellen Computers auf diesem Host hinzugefügt wird.

Beispiel 4: Aktualisieren der Ressourcenreserven für einen Host

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

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl aktualisiert die angegebenen Eigenschaften für VMHost01.

Beispiel 5: Aktualisieren des Benutzernamens und kennworts des Bare-Metal-Computers für einen angegebenen physischen 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

Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost02 ab und speichert das Objekt in der variablen $VMHost.

Der zweite Befehl ruft das Run As-Kontoobjekt mit dem Namen BMCCreds ab und speichert das Objekt in der $BMCRAA Variablen.

Der dritte Befehl aktualisiert den in $VMHost gespeicherten Host mit dem neuen in $BMCRAA gespeicherten Konto "Ausführen als".

Der letzte Befehl aktualisiert den in $VMHost gespeicherten Host mithilfe der Out-of-Band-Schnittstelle, die das Run As-Konto für den Host aktualisiert.

Beispiel 6: Aktualisieren der Zertifikate für XenServer-Hosts in einem 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

Der erste Befehl ruft das Hostobjekt XenHost01 ab und speichert das Objekt in der $VMhost Variablen.

Die zweite ruft das Zertifikatobjekt für XenHost01 ab und speichert das Objekt in der $Certificate Variablen.

Der letzte Befehl verwendet das in $Cert bereitgestellte Zertifikat, um die Kommunikation mit XenHost01 im abgesicherten Modus zu ermöglichen.

Parameter

-ApplyLatestCodeIntegrityPolicy

Gibt an, dass dieser Cmdlet bewirkt, dass der Host seine HVCI-Richtlinie mithilfe des in CodeIntegrityPolicyPathgespeicherten Dateispeicherort aktualisiert.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AttestationServerUrl

Gibt die URL des Nachweisservers an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AvailableForPlacement

Gibt an, ob der VMM-Platzierungsprozess diesen Host oder dieses Volume auf einem Host als möglicher Ort in Betracht ziehen wird, an dem virtuelle Computer bereitgestellt werden sollen. Wenn dieser Parameter auf $False festgelegt ist, können Sie festlegen, dass virtuelle Computer auf diesem Host oder Volume trotzdem bereitgestellt werden sollen. Der Standardwert ist $True. Dieser Parameter gilt nicht für VMware ESX-Hosts.

Wenn Sie diesen Parameter mit Netzwerkadaptern verwenden, berücksichtigt die Platzierung bei festlegung auf $False nicht die logischen Netzwerke, die auf diesem Netzwerkadapter konfiguriert sind, um festzustellen, ob der Host für die Verbindung eines virtuellen Computers geeignet ist.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BaseDiskPaths

Gibt die Pfade zu Basisdatenträgern an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BMCAddress

Gibt die Out-of-Band-Baseboard-Verwaltungscontrolleradresse (BMC) für einen bestimmten physischen Computer an oder aktualisiert sie. Dies kann eine IP-Adresse, der vollqualifizierte Domänenname (FQDN) oder das DNS-Präfix (normalerweise derselbe Name wie der NetBIOS-Name) sein.

In der Regel sind die BMC-Adresse und ihre Verbindung mit dem Netzwerk von der IP-Adresse getrennt, die einem Standardnetzwerkadapter zugeordnet ist. Alternativ verwenden einige Computer einen Standardnetzwerkadapter, um eine einzelne Adresse für den BMC und den Netzwerkadapter bereitzustellen. Die BMC-Adresse hat jedoch einen eindeutigen Port und ist somit eindeutig im Netzwerk identifizierbar.

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

Hinweis: Standardmäßig verwendet VMM eine IP-Adresse oder einen FQDN für die BMCAddress-. Es ist jedoch auch möglich, ein Windows PowerShell-Modul zu erstellen, mit dem Sie andere Adresstypen als BMC-Adresse angeben können.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BMCCustomConfigurationProvider

Gibt ein Konfigurationsanbieterobjekt für einen Baseboard-Verwaltungscontroller (Baseboard Management Controller, BMC) an oder aktualisiert. Ein Konfigurationsanbieter ist ein Plug-In zu VMM, das VMM PowerShell-Befehle in API-Aufrufe übersetzt, die spezifisch für einen BMC-Typ sind. Verwenden Sie diesen Parameter mit der benutzerdefinierten BMCProtocol-.

Typ:	ConfigurationProvider
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BMCPort

Gibt den Out-of-Band-Baseboard-Verwaltungscontroller (BMC)-Port für einen bestimmten physischen Computer an. Ein BMC-Port wird auch als Dienstprozessorport bezeichnet. Beispiel für Standardports sind 623 für IPMI und 443 für SMASH über WS-Man.

Typ:	UInt32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BMCProtocol

Gibt das Protokoll an, das VMM für die Kommunikation mit dem Out-of-Band-Baseboard-Verwaltungscontroller (Out-of-Band Baseboard Management Controller, BMC) verwendet. Gültige Werte sind:

IPMI
ZERSCHMETTERN
Gewohnheit

Ein BMC (auch als Dienstprozessor oder Verwaltungscontroller bezeichnet) ist ein spezieller Controller auf der Hauptplatine eines Servers, der eine Schnittstelle zwischen der Hardware- und Systemverwaltungssoftware fungiert. Wenn die Hauptplatine eines physischen Computers einen BMC enthält, wenn der Computer angeschlossen ist (unabhängig davon, ob es ausgeschaltet oder eingeschaltet ist und ob ein Betriebssystem installiert ist), sind Informationen zur Systemhardware und zum Zustand dieser Systemhardware verfügbar.

Beispielformat: -BMCProtocol "Custom"

Hinweis: Das benutzerdefinierte Protokoll erfordert, dass Sie den BMCCustomConfigurationProvider Parameter verwenden.

Typ:	OutOfBandManagementType
Zulässige Werte:	None, IPMI, SMASH, Custom
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BMCRunAsAccount

Gibt das Run As-Konto an, das mit dem Baseboard-Verwaltungscontroller (Baseboard Management Controller, BMC) verwendet werden soll.

Typ:	RunAsAccount
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-BypassMaintenanceModeCheck

Gibt an, dass die Codeintegritätsrichtlinie auf den Host angewendet wird, auch wenn sich der Host nicht im Wartungsmodus befindet. Standardmäßig schlägt das Anwenden der Codeintegritätsrichtlinie fehl, wenn sich der Host nicht im Wartungsmodus befindet.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CodeIntegrityPolicy

Gibt die Codeintegritätsrichtlinie an, die verwendet werden soll, um die Software einzuschränken, die auf dem Host ausgeführt werden kann.

Typ:	CodeIntegrityPolicy
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CPUPercentageReserve

Gibt den Prozentsatz der CPU an, der für die Verwendung des Betriebssystems auf dem physischen Hostcomputer reserviert werden soll. Wenn Sie diesen Parameter nicht zum Angeben der Reserve verwenden, wird die Standardeinstellung für die Hostgruppe verwendet: 10 Prozent. Der VMM-Platzierungsprozess empfiehlt nicht, dass ein virtueller Computer auf einem Host platziert wird, es sei denn, seine Ressourcenanforderungen können erfüllt werden, ohne Hostreserven zu verwenden.

Typ:	UInt16
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False