Set-SCVirtualizationManager
Changes the properties of a VMware vCenter Server that is managed by VMM.
Syntax
Default (Default)
Set-SCVirtualizationManager
[-VirtualizationManager] <VirtualizationManager>
[-EnableSecureMode <Boolean>]
[-Credential <VMMCredential>]
[-TCPPort <UInt32>]
[-Certificate <ClientCertificate>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<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.
Parameter properties
| Type: | ClientCertificate |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | VMMCredential |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-EnableSecureMode
Indicates whether VMM communicates with VMware ESX hosts and Citrix XenServer hosts in secure mode. The default value is $True.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | SecureMode |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-TCPPort
Specifies a numeric value that represents a TCP port.
Parameter properties
| Type: | UInt32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VirtualizationManager
Specifies a virtualization manager object managed by VMM.
Parameter properties
| Type: | VirtualizationManager |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
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.