vSphere PowerCLI Reference

Set-PowerCLIConfiguration

Synopsis

Modifies the vSphere PowerCLI configuration.

Syntax

Set-PowerCLIConfiguration [-ProxyPolicy <ProxyPolicy>] [-DefaultVIServerMode <DefaultVIServerMode>] [-DisplayDeprecationWarnings [<Boolean>]] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Get-PowerCLIConfiguration

Detailed Description

Modifies the vSphere PowerCLI configuration. You can specify whether the vSphere PowerCLI uses a system proxy server to connect to the vSphere server. Also, you can use the DefaultVIServerMode parameter to set the default servers policy. For more information about default servers, see the description of Connect-VIServer.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ConfirmSwitchParameterIf the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.falsefalse$true
DefaultVIServerModeDefaultVIServerModeChange the server connection mode. The new configuration takes effect immediately after you run the cmdlet. The following values are valid:

- Single - Switching to "single" removes all server connections except the last established one. If no target servers are specified, cmdlets run only on the last connected server.

- Multiple - All servers connected after switching to "multiple" mode are stored together with the current server connection in an array variable. If no target servers are specified, cmdlets run on the servers in the variable.

For more information on default servers, see the description of Connect-VIServer.
falsefalse
DisplayDeprecationWarningsBooleanIndicate whether you want to see warnings about deprecated elements.falsefalse
ProxyPolicyProxyPolicySpecify whether the vSphere PowerCLI uses a system proxy server to connect to the vSphere server. The valid values are NoProxy and UseSystemProxy.falsetrue (ByValue)
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

PowerCLIConfiguration

Notes

Examples

-------------- Example 1 --------------

Set-PowerCLIConfiguration -ProxyPolicy NoProxy -Confirm

Specifies that the VMware vSphere PowerCLI does not use a proxy server to connect to the vSphere server.

-------------- Example 2 --------------

Set-PowerCLIConfiguration -DefaultVIServerMode multiple ?Confirm

Sets the server connection mode of PowerCLI to "multiple".

-------------- Example 3 --------------

Set-PowerCLIConfiguration -ProxyPolicy NoProxy -DefaultVIServerMode Single

Changes the default server connection mode and the proxy policy of PowerCLI.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.