Set-SCVMMServer

修改 VMM 管理服务器的属性。

语法

Set-SCVMMServer
   [-DiagnosticsAndUsageData <Boolean>]
   [-VMRCAccessAccount <String>]
   [-VMRCDefaultPort <UInt32>]
   [-VMConnectDefaultPort <UInt32>]
   [-LibraryRefresherEnabled <Boolean>]
   [-LibraryRefresherFrequency <UInt16>]
   [-AutomaticLogicalNetworkCreationEnabled <Boolean>]
   [-LogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-BackupLogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-AutomaticVirtualNetworkCreationEnabled <Boolean>]
   [-VMSubnetIDRangeStart <UInt32>]
   [-VMSubnetIDRangeEnd <UInt32>]
   [-VMConnectTimeToLiveInMinutes <Int32>]
   [-VMConnectGatewayCertificatePath <String>]
   [-VMConnectGatewayCertificatePassword <SecureString>]
   [-VMConnectHyperVCertificatePath <String>]
   [-VMConnectHyperVCertificatePassword <SecureString>]
   [-VMConnectNCCertificatePath <String>]
   [-VMConnectNCCertificatePassword <SecureString>]
   [-VMConnectHostIdentificationMode <VMConnectHostIDMode>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-ShieldingHelperVhd <VirtualHardDisk>]
   [-VMMServer <ServerConnection>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCVMMServer cmdlet 修改 Virtual Machine Manager (VMM) 管理服务器的一个或多个属性。 可以使用 Set-SCVMMServer cmdlet 更改的 VMM 设置包括:

配置联合身份验证

可以使用 Set-SCVMMServer 提供的参数来配置联合身份验证。 联合身份验证允许用户连接到虚拟机的控制台,而无需在 Hyper-V 主机计算机上提供凭据。 使用 New-SCVMConnectFedAuth cmdlet 颁发联合身份验证令牌。

参与 Microsoft 客户体验改善计划 (CEIP)

可以使用 Set-SCVMMServer 指定是否为此 VMM 管理服务器启用 Service Quality Metrics (SQM) 。

库设置

可以使用 Set-SCVMMServer 指定是否启用 VMM 库刷新程序,如果是,则刷新库中的对象的频率。

网络设置

可以使用 Set-VMMServer cmdlet 配置如何匹配逻辑网络。 还可以自动启用逻辑和虚拟网络的创建。

远程控制

可以使用 Set-SCVMMServer 配置连接到虚拟机时要使用的默认远程控制端口, (VMConnect) 。

自助服务用户的联系人

可以使用 Set-SCVMMServer 指定支持自助服务用户的管理员的电子邮件地址。

来宾代理设置

可以使用 Set-SCVMMServer 选择用于与 VMM 来宾代理通信的方法:FQDN 或 IP 地址。

示例

示例 1:设置刷新库的频率

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -LibraryRefresherEnabled $True -LibraryRefresherFrequency 24

此命令为 VMMServer01 启用库刷新,并将刷新频率速率设置为每 24 小时一次。

示例 2:选择退出客户体验改善计划

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -CEIPOptIn $False

此命令通过将 CEIPOptIn 参数设置为 VMMServer01 上的 $False,选择退出参与 Microsoft 客户体验改善计划 (CEIP) 。

示例 3:指定自助服务联系人电子邮件地址

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -SelfServiceContactEmail "AdminHelp@Contoso.com"

此命令将 VMMServer01 上的自助服务联系人电子邮件地址设置为 AdminHelp@Contoso.com 。

参数

-AttestationServerUrl

指定证明服务器的 URL。

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

-AutomaticLogicalNetworkCreationEnabled

指示是否自动创建逻辑网络。 设置为$True时,会基于逻辑网络匹配设置创建新的逻辑网络(如果主机网络适配器未与逻辑网络相关联)。

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

-AutomaticVirtualNetworkCreationEnabled

指示是否自动创建虚拟网络。 设置为$True时,如果主机有一个网络适配器用于放置与逻辑网络关联的位置,但没有附加到适配器的虚拟网络,则会创建新的虚拟网络。

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

-BackupLogicalNetworkMatch

指定主网络匹配方法不可用时要使用的网络匹配方法。

Type:LogicalNetworkMatchOption
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiagnosticsAndUsageData

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

-JobVariable

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

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

-KeyProtectionServerUrl

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

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

-LibraryRefresherEnabled

指示在设置为$True时,将刷新 VMM 库对象。

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

-LibraryRefresherFrequency

指定 VMM 库中对象的刷新频率,单位为小时。 默认设置为 1 小时。

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

-LogicalNetworkMatch

指定要用于自动创建逻辑网络的逻辑网络匹配方法。 此参数的可接受值为:

  • 已禁用
  • FirstDNSSuffixLabel
  • DNSSuffix
  • NetworkConnectionName
  • VirtualNetworkSwitchName
Type:LogicalNetworkMatchOption
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

指定端口 ACL 对象。

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

-PROTipID

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

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

-RemovePortACL

指示此操作删除 ACL (端口访问控制列表) 。

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

-RunAsynchronously

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

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

-ShieldingHelperVhd

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

-VMConnectDefaultPort

在此 VMM 服务器管理的所有 Hyper-V 主机上指定用于虚拟机连接 (VMConnect) 会话的 TCP 端口的默认值。 通常,默认端口为 2179,但可以使用该参数更改默认值。 此参数不适用于 VMware ESX 服务器主机或 Citrix XenServer 主机。

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

-VMConnectGatewayCertificatePassword

将网关证书密码指定为安全字符串。 指定 VMConnectGatewayCertificatePath 参数时,必须为此参数指定值。

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

-VMConnectGatewayCertificatePath

指定私钥证书 (.pfx 文件) 的路径。

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

-VMConnectHostIdentificationMode

指定如何标识 Hyper-V 主机。 此参数的可接受值为:

  • FQDN
  • IPv4
  • IPv6
  • HostName
Type:VMConnectHostIDMode
Accepted values:FQDN, IPv4, IPv6, HostName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHyperVCertificatePassword

将 Hyper-V 证书密码指定为安全字符串。 指定 VMConnectHyperVCertificatePath 参数时,必须为此参数指定值。

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

-VMConnectHyperVCertificatePath

指定私钥证书 (.pfx 文件) 的路径。

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

-VMConnectNCCertificatePassword

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

-VMConnectNCCertificatePath

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

-VMConnectTimeToLiveInMinutes

指定令牌颁发的有效期限(以分钟为单位)。 有效值为 1 到 60。

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

-VMMServer

指定VMM 服务器对象。

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

-VMRCAccessAccount

指定使用虚拟机远程控制 (VMRC) 连接到虚拟机时要使用的帐户。

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

-VMRCDefaultPort

指定使用 VMRC 连接到虚拟机时要使用的默认端口。

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

-VMSubnetIDRangeEnd

指定虚拟机子网 ID 范围的结束 ID。

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

-VMSubnetIDRangeStart

指定虚拟机子网 ID 范围的起始 ID。

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

输出

VMMServer

此 cmdlet 返回 VMMServer 对象。