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 对象。