Set-SCVMHost

修改虚拟机主机的属性。

语法

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

说明

Set-SCVMHost cmdlet 修改由 Virtual Machine Manager (VMM) 管理的虚拟机主机的一个或多个属性。 可以使用 Set-SCVMHost cmdlet 修改的设置汇总如下:

作为虚拟机主机的可用性

可以指定 VMM 放置过程当前是否将主机视为放置虚拟机的候选项。

主机保留设置

可以配置下列主机预留设置:

  • 为主机使用而预留的 CPU 使用率百分比。
  • (MB) 预留的磁盘空间量供主机使用。
  • 每秒的最大磁盘 I/O 操作数 (IOPS) ,以便由主机使用。
  • 为主机使用而预留的内存量 (MB) 。
  • 为主机使用而预留的网络容量百分比。

除非可以在不使用主机保留的情况下满足虚拟机的资源要求,否则 VMM 放置过程不建议将虚拟机放置在主机上。 如果未指定保留设置,VMM 将使用默认设置。

虚拟机路径

可以将主机上的多个位置指定为一系列默认路径,用于存储虚拟机文件。

用于管理外围网络或非受信任域中的主机的凭据

可以为用于管理位于外围网络或非受信任域中的 Hyper-V 主机的帐户指定密码。

远程连接设置

可以为 Hyper-V 主机配置远程连接设置, (VMConnect) ,使用户能够远程连接到虚拟机。 此设置不适用于 VMware ESX 主机上的虚拟机。

示例

示例 1:使主机可供放置

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

第一个命令获取名为 VMHost01 的主机对象,并将对象存储在$VMHost变量中。

第二个命令使 VMHost01 可用作虚拟机的主机。 将 AvailableForPlacement 参数设置为 True 使 VMM 放置过程能够将此主机评估为要在其中部署虚拟机的可能候选项。

示例 2:在 Hyper-V 主机上启用远程连接

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

第一个命令获取名为 VMHost01 的主机对象,并将对象存储在$VMHost变量中。

第二个命令在 VMHost01 上启用远程连接,并将用于远程连接的端口设置为 5900。

在 Hyper-V 主机上启用远程连接允许用户远程访问和管理主机上的虚拟机。

示例 3:更新主机的虚拟机路径

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

第一个命令获取名为 VMHost01 的主机对象,并将对象存储在$VMHost变量中。

第二个命令通过将路径 D:\VirtualMachinePath 添加到该主机上的虚拟机路径列表来更新存储在$VMHost中的主机的 VMPaths 属性。

示例 4:更新主机的资源预留

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

第一个命令获取名为 VMHost01 的主机对象,并将对象存储在$VMHost变量中。

第二个命令更新 VMHost01 的指定属性。

示例 5:更新指定物理主机的裸机计算机用户名和密码

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

第一个命令获取名为 VMHost02 的主机对象,并将对象存储在$VMHost变量中。

第二个命令获取名为 BMCCreds 的运行方式帐户对象,并将对象存储在$BMCRAA变量中。

第三个命令使用存储在$BMCRAA中的新运行方式帐户更新存储在$VMHost中的主机。

最后一个命令使用带外接口刷新存储在$VMHost中的主机,该接口更新主机的运行方式帐户。

示例 6:更新群集中 XenServer 主机的证书

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

第一个命令获取名为 XenHost01 的主机对象,并将对象存储在$VMhost变量中。

第二个获取 XenHost01 的证书对象,并将对象存储在$Certificate变量中。

最后一个命令使用$Cert中提供的证书,使 VMM 能够在安全模式下与 XenHost01 通信。

参数

-ApplyLatestCodeIntegrityPolicy

指示此 cmdlet 使主机使用 CodeIntegrityPolicyPath 中存储的文件位置更新其 HVCI 策略。

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

-AttestationServerUrl

指定证明服务器的 URL。

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

-AvailableForPlacement

指示 VMM 放置过程将考虑此主机或主机上的此卷是否有资格作为部署虚拟机的可能位置。 如果此参数设置为$False,则可以选择在此主机或卷上部署虚拟机。 默认值为$True。 此参数不适用于 VMware ESX 主机。

将此参数与网络适配器一起使用时,如果设置为$False,则放置不考虑在此网络适配器上配置的逻辑网络,以确定主机是否适合连接虚拟机。

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

-BaseDiskPaths

指定基磁盘的路径。

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

-BMCAddress

指定或更新特定物理计算机的带外基板管理控制器 (BMC) 地址。 这可能是 IP 地址、 (FQDN) 的完全限定域名,或者 DNS 前缀 (通常与 NetBIOS 名称) 相同。

通常,BMC 地址及其与网络的连接独立于与标准网络适配器关联的 IP 地址。 或者,某些计算机确实使用标准网络适配器为 BMC 和网络适配器提供单个地址。 但是,BMC 地址具有唯一的端口,因此在网络上唯一可识别。

  • 示例 IPv4 格式: -BMCAddress "10.0.0.21"
  • 示例 Ipv6 格式: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • 示例 FQDN 格式: -BMCAddress "Computer01.Contoso.com"
  • NetBIOS 格式示例: -BMCAddress "Computer01"

注意:默认情况下,VMM 对 BMCAddress 使用 IP 地址或 FQDN。 但是,还可以创建一个Windows PowerShell模块,使你可以将其他类型的地址指定为 BMC 地址。

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

-BMCCustomConfigurationProvider

指定或更新基板管理控制器的配置提供程序对象, (BMC) 。 配置提供程序是 VMM 的插件,用于将 VMM PowerShell 命令转换为特定于 BMC 类型的 API 调用。 将此参数与自定义 BMCProtocol 配合使用。

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

-BMCPort

指定或更新特定物理计算机的带外基板管理控制器 (BMC) 端口。 BMC 端口也称为服务处理器端口。 示例默认端口为 623(对于 IPMI)和 443,适用于 WS-Man 的 SMASH。

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

-BMCProtocol

指定或更新 VMM 用来与带外基板管理控制器通信的协议, (BMC) 。 有效值为:

  • IPMI
  • 粉碎
  • 自定义

BMC (也称为服务处理器或管理控制器) 是服务器主板上的专用控制器,在硬件和系统管理软件之间充当接口。 如果物理计算机的主板包括 BMC,则当计算机被插入 (是关机还是开机,以及操作系统是否安装在) 、系统硬件的相关信息以及系统硬件运行状况的状态可用时。

示例格式: -BMCProtocol "Custom"

注意:自定义协议要求使用 BMCCustomConfigurationProvider 参数。

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

-BMCRunAsAccount

指定要与基板管理控制器一起使用的运行方式帐户, (BMC) 设备。

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

-BypassMaintenanceModeCheck

指示即使主机不在维护模式下,代码完整性策略也会应用到主机。 默认情况下,如果主机未处于维护模式,则应用代码完整性策略会失败。

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

-CodeIntegrityPolicy

指定要用于限制可在主机上运行的软件的代码完整性策略。

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

-CPUPercentageReserve

指定在物理主机计算机上使用操作系统时要保留的 CPU 百分比。 如果不使用此参数指定保留,将使用主机组的默认设置:10%。 VMM 放置过程不会建议虚拟机放置在主机上,除非可以在不使用主机保留的情况下满足其资源要求。

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

-Custom1

指定虚拟机主机上的自定义属性。

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

-Custom10

指定虚拟机主机上的自定义属性。

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

-Custom2

指定虚拟机主机上的自定义属性。

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

-Custom3

指定虚拟机主机上的自定义属性。

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

-Custom4

指定虚拟机主机上的自定义属性。

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

-Custom5

指定虚拟机主机上的自定义属性。

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

-Custom6

指定虚拟机主机上的自定义属性。

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

-Custom7

指定虚拟机主机上的自定义属性。

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

-Custom8

指定虚拟机主机上的自定义属性。

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

-Custom9

指定虚拟机主机上的自定义属性。

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

-Description

指定 Host 对象的说明。

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

-DiskSpaceReserveMB

指定磁盘空间量(以兆字节 (MB) ),以便在物理主机计算机上使用操作系统。 如果不使用此参数指定保留,则主机组的默认设置为 100 MB。 VMM 放置过程不建议将虚拟机放置在主机上,除非可以在不使用主机保留的情况下满足其资源要求。

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

-EnableLiveMigration

指示是否在主机上启用实时迁移。

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

-FibreChannelWorldWideNodeName

指定光纤通道全球节点名称。

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

-FibreChannelWorldWidePortNameMaximum

指定光纤通道世界范围的端口名称范围的最大值。

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

-FibreChannelWorldWidePortNameMinimum

指定光纤通道世界范围的端口名称范围的最小值。

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

-IsDedicatedToNetworkVirtualizationGateway

指示主机是否专用于网络虚拟化网关。

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

-JobGroup

在运行最后一个包含相同作业组标识符的命令之前,为作为集合运行的一系列命令指定标识符。

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

-JobVariable

指定跟踪作业进度,并将其存储在此参数命名的变量中。

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

-KeyProtectionServerUrl

指定密钥保护服务器的 URL (KPS) 。

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

-LiveMigrationMaximum

指定同时实时迁移的最大数目。

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

-LiveStorageMigrationMaximum

指定同时实时存储迁移的最大数目。

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

-MaintenanceHost

此参数已作废。 请改用 AvailableForPlacement

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

-ManagementAdapterMACAddress

指定 VMM 服务器用来与此主机通信的计算机上的物理网络适配器的 MAC 地址。

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

-MaxDiskIOReservation

指定物理主计算机上每秒的最大磁盘 I/O (IOPS) 。 如果不使用此参数来指定保留,则主机组的默认设置为 10000。 VMM 放置过程不建议将虚拟机放置在主机上,除非可以在不使用主机保留的情况下满足其资源要求。

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

-MemoryReserveMB

指定内存量(以兆字节 (MB) ),以便在物理主机计算机上使用主机操作系统。 如果不使用此参数指定保留,则主机组的默认设置为 256 MB。 VMM 放置过程不建议将虚拟机放置在主机上,除非可以在不使用主机保留的情况下满足其资源要求。

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

-MigrationAuthProtocol

指定用于迁移的授权协议。 此参数的可接受值为:CredSSP、Kerberos。

Type:MigrationAuthProtocolType
Accepted values:CredSSP, Kerberos
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationPerformanceOption

指定迁移性能选项类型。 此参数的可接受值为:

  • 标准
  • UseCompression
  • UseSmbTransport
Type:MigrationPerformanceOptionType
Accepted values:Standard, UseCompression, UseSmbTransport
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MigrationSubnet

指定要用于迁移的子网数组。

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

-NetworkPercentageReserve

指定要在物理主机计算机上使用主机操作系统的网络容量百分比。 如果不使用此参数来指定保留,则主机组的默认设置为 10%。 VMM 放置过程不建议将虚拟机放置在主机上,除非可以在不使用主机保留的情况下满足其资源要求。

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

-NumaSpanningEnabled

指示是否启用 NUMA 跨越。

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

-OverrideHostGroupReserves

指示设置为$True时,由提供的设置覆盖父主机组中的主机保留设置。

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

-PROTipID

指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。

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

-RemoteConnectCertificatePath

此参数已作废。

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

-RemoteConnectEnabled

启用,当设置为$True时,主机服务器上的连接允许用户远程连接到其虚拟机。 此参数仅适用于 Hyper-V 主机上的虚拟机。 它不适用于 VMware ESX 主机或 Citrix XenServer 主机上的虚拟机。

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

-RemoteConnectPort

指定远程用户连接到虚拟机时使用的 TCP 端口的默认值。 通常,Hyper-V 主机的默认端口为 2179。 此参数不适用于 VMware ESX 主机或 Citrix XenServer 主机。

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

-RemoveRemoteConnectCertificate

此参数已作废。

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

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令 shell。

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

-SecureRemoteConnectEnabled

此参数已作废。

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

-SMBiosGuid

为与 VMM 中该物理计算机关联的物理计算机指定系统管理 BIOS 全局唯一标识符 (SMBIOS GUID) 。 SMBIOS 定义数据结构和访问方法,使用户或应用程序能够在此计算机上存储和检索有关硬件的信息,例如系统名称、制造商或系统 BIOS 版本。 Windows 操作系统在系统启动时检索 SMBIOS 数据,并使这些数据可供程序使用。

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

-UseAnyMigrationSubnet

指示是否可以使用任何子网进行迁移。

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

-VMHost

指定一个虚拟主机对象。 VMM 支持 Hyper-V 主机、VMware ESX 主机和 Citrix XenServer 主机。

有关每种类型的主机的详细信息,请参阅 Add-SCVMHost cmdlet。

Type:Host
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-VMHostManagementCredential

此参数已作废。

Type:VMMCredential
Aliases:PerimeterNetworkHostCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VMPaths

指定主机上可用于存储虚拟机文件的一组默认路径(作为用管道运算符分隔的字符串)。

示例格式: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

输出

Host

此 cmdlet 返回 Host 对象。