Set-SCVMMServer

Changes properties of the VMM management server.

Description

Changes one or more properties of the System Center Virtual Machine Manager (VMM) management server. VMM settings that you can change with the Set-SCVMMServer cmdlet include the following:

Microsoft Customer Experience Improvement Program (CEIP) Participation
----------------------------------------------------------------------
You can use Set-SCVMMServer to specify whether to enable Service Quality Metrics (SQM) for this VMM management server.

Library Settings
----------------
You can use Set-SCVMMServer to specify whether the Virtual Machine Manager library refresher is enabled and, if so, how often objects in the library are refreshed.

Remote Control
--------------
You can use Set-SCVMMServer to configure the default remote control port to use when connecting to virtual machines (VMConnect).

Contact for Self-Service Users
------------------------------
You can use Set-SCVMMServer to specify the e-mail address of an administrator who supports self-service users.

Network Settings
----------------
You can use the Set-VMMServer cmdlet to configure how to match logical networks. You can also enable creation of logical and virtual networks automatically.

Guest Agent Settings
--------------------
You can use Set-SCVMMServer to select the method used to communicate wit the VMM guest agent: FQDN or IP Address.

Parameters

AutomaticLogicalNetworkCreationEnabled

Required? false
Accept Pipeline Input? false
Position? named
Indicates whether logical networks are created automatically. When set to $True, a new logical network is created, based on the logical network matching settings, if the host network network adapter is not associated with a logical network.

AutomaticVirtualNetworkCreationEnabled

Required? false
Accept Pipeline Input? false
Position? named
Indicates whether virtual networks are created automatically. When set to $True, if a host has one network adapter for placement associated with a logicak network, but no virtual networks attached to the adapter, a new virtual network is created.

BackupLogicalNetworkMatch

Required? false
Accept Pipeline Input? false
Position? named
Specifies the network matching method to use if the primary network matching method is not available.

CEIPOptIn

Required? false
Accept Pipeline Input? false
Position? named
Enables Service Quality Metrics (SQM) for this server and thus participation in the Microsoft Customer Experience Improvement Program (CEIP), which collects information about problems customers encounter in order to improve the software in a later release.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

LibraryRefresherEnabled

Required? false
Accept Pipeline Input? false
Position? named
Indicates, when set to $True, that VMM library objects are refreshed.

LibraryRefresherFrequency

Required? false
Accept Pipeline Input? false
Position? named
Specifies, in hours, the frequency at which objects in the VMM library are refreshed. The default setting is 1 hour.

LogicalNetworkMatch

Required? false
Accept Pipeline Input? false
Position? named
Specifies the logical network matching method to use for automatically creating logical networks. Valid values are: Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 

SelfServiceContactEmail

Required? false
Accept Pipeline Input? false
Position? named
Specifies the e-mail address of a VMM administrator that self-service users can contact if they encounter a problem.

UseIPForVMGuestCommunication

Required? false
Accept Pipeline Input? false
Position? named
Indicates whether the IP address for a virtual machine is used to communicate with the guest agent. When set to $True, the IP address is used, which is a less secure form of communication. When set to $False, the FQDN is used, which is a more secure form of communication.

VMConnectDefaultPort

Required? false
Accept Pipeline Input? false
Position? named
Specifies the default value for the TCP port used for Virtual Machine Connection (VMConnect) sessions on all Hyper-V hosts managed by this VMM server. Typically, the default port is 2179, but you can use this parameter to change the default. This parameter does not apply to VMware ESX Server hosts or Citrix XenServer hosts.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named
Specifies a VMM server object.

VMRCAccessAccount

Required? false
Accept Pipeline Input? false
Position? named
Specifies the account to use when connecting to a virtual machine by using Virtual Machine Remote Control (VMRC).

VMRCDefaultPort

Required? false
Accept Pipeline Input? false
Position? named
Specifies the default port to use when connecting to a virtual machine by using Virtual Machine Remote Control (VMRC).

Examples

1: Set the frequency at which the library is refreshed.
PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -LibraryRefresherEnabled $TRUE -LibraryRefresherFrequency 24
This command enables library refreshing for VMMServer01 and sets the refreshing frequency rate to every 24 hours.
2: Opt out of the Customer Experience Improvement Program.
PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -CEIPOptIn $False
This command opts out of participation in the Microsoft Customer Experience Improvement Program (CEIP) by setting the CEIPOptIn parameter to $False on VMMServer01.
3: Specify a self-service contact e-mail address.
PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -SelfServiceContactEmail "AdminHelp@Contoso.com"
This command sets the self service contact e-mail address to "AdminHelp@Contoso.com" on VMMServer01.

See Also