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 管理服务器启用服务质量指标(SQM)。

库设置

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

网络设置

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

遥控

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

Self-Service 用户的联系人

可以使用 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。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AutomaticLogicalNetworkCreationEnabled

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AutomaticVirtualNetworkCreationEnabled

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-BackupLogicalNetworkMatch

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

类型:LogicalNetworkMatchOption
接受的值:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DiagnosticsAndUsageData

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-JobVariable

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-KeyProtectionServerUrl

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LibraryRefresherEnabled

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LibraryRefresherFrequency

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

类型:UInt16
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LogicalNetworkMatch

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

  • 禁用
  • FirstDNSSuffixLabel
  • DNSSuffix
  • NetworkConnectionName
  • VirtualNetworkSwitchName
类型:LogicalNetworkMatchOption
接受的值:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PortACL

指定端口 ACL 对象。

类型:PortACL
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

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

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RemovePortACL

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RunAsynchronously

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ShieldingHelperVhd

类型:VirtualHardDisk
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectDefaultPort

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

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectGatewayCertificatePassword

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

类型:SecureString
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectGatewayCertificatePath

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectHostIdentificationMode

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

  • FQDN
  • IPv4
  • IPv6
  • HostName
类型:VMConnectHostIDMode
接受的值:FQDN, IPv4, IPv6, HostName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectHyperVCertificatePassword

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

类型:SecureString
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectHyperVCertificatePath

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectNCCertificatePassword

类型:SecureString
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectNCCertificatePath

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMConnectTimeToLiveInMinutes

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

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMMServer

指定 VMM 服务器对象。

类型:ServerConnection
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VMRCAccessAccount

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMRCDefaultPort

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

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMSubnetIDRangeEnd

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

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMSubnetIDRangeStart

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

类型:UInt32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

VMMServer

此 cmdlet 返回 VMMServer 对象。