Set-SCVirtualizationManager

Changes the properties of a VMware vCenter Server that is managed by VMM.

Syntax

Set-SCVirtualizationManager [-VirtualizationManager] <VirtualizationManager> [-Certificate <ClientCertificate>]
 [-Credential <VMMCredential>] [-EnableSecureMode <Boolean>] [-JobVariable <String>] [-PROTipID <Guid>]
 [-RunAsynchronously] [-TCPPort <UInt32>] [<CommonParameters>]

Description

The Set-SCVirtualizationManager cmdlet changes one or more properties of a VMware vCenter Server that is managed by Virtual Machine Manager (VMM). A vCenter Server manages VMware ESX hosts and VMware-based virtual machines.

Properties that you can change include settings for the TCP port used to connect to the vCenter Server, credentials used to access the vCenter Server, and updating a vCenter Server security certificate.

If a security certificate for a vCenter Server expires or a self-signed certificate is replaced by a certificate from a third-party certification authority (CA), you must update both the vCenter Server and VMM:



- First, replace the current vCenter certificate with the new certificate in vCenter. Refer to the VMware documentation for instructions.

  • Next, update the certificate in VMM by importing the new certificate into VMM.

    For more information about including a VMware VirtualCenter Server as a virtualization managers in a Virtual Machine Manager environment, type Get-Help Add-SCVirtualizationManager -Detailed.

Examples

Example 1: Specify new credentials for a virtualization manager

PS C:\> $VirtManager = Get-SCVirtualizationManager -ComputerName "VirtMgrServer01.Contoso.com"
PS C:\> $Credential = Get-SCRunAsAccount -Name "RunAsAccount04"
PS C:\> Set-SCVirtualizationManager -VirtualizationManager $VirtManager -Credential $Credential

The first command gets the virtualization manager object named VirtMgrServer01 from the VMM database and stores the object in the $VirtManager variable.

The second command gets the Run As account named Host Computer Account 04 and stores it in the $Credential variable.

The last command changes the stored credentials for VirtMgrServer01 that are used when VMM connects to the external service.

Parameters

-Certificate

Specifies a security certificate object.

Type:ClientCertificate
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Credential

Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task.

For more information about the PSCredential object, type Get-Help Get-Credential.

For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

Type:VMMCredential
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableSecureMode

Indicates whether VMM communicates with VMware ESX hosts and Citrix XenServer hosts in secure mode. The default value is $True.

Type:Boolean
Aliases:SecureMode
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

Specifies that job progress is tracked and stored in the variable named by this parameter.

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

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

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

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

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

Specifies a numeric value that represents a TCP port.

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

Specifies a virtualization manager object managed by VMM.

Type:VirtualizationManager
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

VirtualizationManager

This cmdlet returns a **VirtualizationManager** object.

Notes

* Requires a VMM virtualization manager object, which can be retrieved by using the **Get-SCVirtualizationManager** cmdlet.