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 mindestens eine Eigenschaft eines virtuellen Computerhosts, der von 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 Virtual Machines

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 Einstellungen für Hostreserven konfigurieren:

Prozentsatz der CPU-Auslastung für die Verwendung durch den Host.
Speicherplatz (MB), der für die Verwendung durch den Host festgelegt werden soll.
Maximale Anzahl von Datenträger-I/O-Vorgängen pro Sekunde (IOPS), die für die Verwendung durch den Host festgelegt werden sollen.
Menge des Arbeitsspeichers (MB), der für die Verwendung durch den Host festgelegt werden soll.
Prozentsatz der Netzwerkkapazität für die Nutzung durch den Host.

Der VMM-Platzierungsprozess empfiehlt nicht, 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 zu virtuellen Maschinen

Sie können in Form eines Satzes von Standardpfaden Speicherorte auf einem Host angeben, in denen Dateien für virtuelle Maschinen 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 Maschinen auf VMware ESX-Hosts.

Beispiele

Beispiel 1: Stellen Sie einen Host für die Platzierung zur Verfügung

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

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

Der zweite Befehl macht VMHost01 als Host für virtuelle Computer verfügbar. Durch Festlegen des Parameters "AvailableForPlacement " auf "True" 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 namens 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.

Durch aktivieren von Remoteverbindungen auf einem Hyper-V-Host können Benutzer remote auf ihre virtuellen Computer auf dem Host zugreifen und 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 namens 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 virtueller Computer 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 namens 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 des Kennworts 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 namens VMHost02 ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl ruft das Run As-Kontoobjekt namens 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 Run As-Konto.

Der letzte Befehl aktualisiert den in $VMHost gespeicherten Host mithilfe seiner 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 namens 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 sicheren Modus zu ermöglichen.

Parameter

-ApplyLatestCodeIntegrityPolicy

Gibt an, dass dieser Cmdlet bewirkt, dass der Host seine HVCI-Richtlinie mithilfe des Dateispeicherorts aktualisiert, der in CodeIntegrityPolicyPath gespeichert ist.

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

-AttestationServerUrl

Gibt die URL des Nachweisservers an.

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

-AvailableForPlacement

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

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

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

-BaseDiskPaths

Gibt die Pfade zu Basisdatenträgern an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 sein (dies ist in der Regel derselbe Name wie der NetBIOS-Name).

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 einzige Adresse für den BMC und den Netzwerkadapter bereitzustellen. Die BMC-Adresse weist jedoch einen eindeutigen Port auf und ist somit eindeutig identifizierbar im Netzwerk.

Beispiel-IPv4-Format: -BMCAddress "10.0.0.21"
Beispiel-Ipv6-Format: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
Beispiel-FQDN-Format: -BMCAddress "Computer01.Contoso.com"
Beispiel für NetBIOS-Format: -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 Typen von Adressen als BMC-Adresse angeben können.

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

-BMCCustomConfigurationProvider

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

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

-BMCPort

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

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

-BMCProtocol

Gibt das Protokoll an, das VMM verwendet, um mit dem Out-of-Band-Baseboard-Verwaltungscontroller (BMC) zu kommunizieren. Gültige Werte sind:

IPMI
SMASH
Benutzerdefiniert

Ein BMC (auch als Dienstprozessor oder Verwaltungscontroller bezeichnet) ist ein spezieller Controller auf dem Motherboard eines Servers, der eine Schnittstelle zwischen der Hardware- und Systemverwaltungssoftware fungiert. Wenn das Motherboard 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), finden Sie Informationen zur Systemhardware und zum Zustand dieser Systemhardware.

Beispielformat: -BMCProtocol "Custom"

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

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

-BMCRunAsAccount

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

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

-BypassMaintenanceModeCheck

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

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

-CodeIntegrityPolicy

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

Type:	CodeIntegrityPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 verwenden, um die Reserve anzugeben, 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 ohne Hostreserven erfüllt werden.

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