Set-PowerCLIConfiguration

VMware: Modifies the VMware PowerCLI configuration

Script

#Requires -Version 5.1
[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [ValidateSet("Session", "User", "AllUsers")]
    [string]$Scope = "User",
    [ValidateSet("Fail", "Ignore", "Prompt", "Unset", "Warn")]
    [string]$InvalidCertificateAction,
    [ValidateSet("Multiple", "Single")]
    [string]$DefaultVIServerMode,
    [bool]$DisplayDeprecationWarnings,
    [int32]$WebOperationTimeoutSeconds,
    [ValidateSet("UseSystemProxy", "NoProxy")]
    [string]$ProxyPolicy,
    [bool]$ParticipateInCEIP,
    [ValidateSet("UseSystemProxy", "NoProxy")]
    [string]$CEIPDataTransferProxyPolicy
)
Process {
    try {
        $setArgs = @{ ErrorAction = 'Stop'; Scope = $Scope; Confirm = $false }
        if ($WebOperationTimeoutSeconds -gt 0) { $null = Set-PowerCLIConfiguration @setArgs -WebOperationTimeoutSeconds $WebOperationTimeoutSeconds }
        if (-not [System.String]::IsNullOrWhiteSpace($InvalidCertificateAction)) { $null = Set-PowerCLIConfiguration @setArgs -InvalidCertificateAction $InvalidCertificateAction }
        if (-not [System.String]::IsNullOrWhiteSpace($DefaultVIServerMode)) { $null = Set-PowerCLIConfiguration @setArgs -DefaultVIServerMode $DefaultVIServerMode }
        if (-not [System.String]::IsNullOrWhiteSpace($ProxyPolicy)) { $null = Set-PowerCLIConfiguration @setArgs -ProxyPolicy $ProxyPolicy }
        if ($PSBoundParameters.ContainsKey('DisplayDeprecationWarnings')) { $null = Set-PowerCLIConfiguration @setArgs -DisplayDeprecationWarnings $DisplayDeprecationWarnings }
        if ($PSBoundParameters.ContainsKey('ParticipateInCEIP')) { $null = Set-PowerCLIConfiguration @setArgs -ParticipateInCEIP $ParticipateInCEIP }
        if (-not [System.String]::IsNullOrWhiteSpace($CEIPDataTransferProxyPolicy)) { $null = Set-PowerCLIConfiguration @setArgs -CEIPDataTransferProxyPolicy $CEIPDataTransferProxyPolicy }
        $result = Get-PowerCLIConfiguration -Scope $Scope -ErrorAction Stop | Format-List
        Write-Output $result
    }
    catch { throw }
}

Customize

Scope string

Scope: Session, User, or AllUsers

InvalidCertificateAction string

Action on certificate errors: Fail, Ignore, Prompt, Unset, Warn

DefaultVIServerMode string

Server connection mode: Multiple or Single

DisplayDeprecationWarnings bool

Show warnings about deprecated elements

WebOperationTimeoutSeconds int32

Timeout for Web operations

ProxyPolicy string

System proxy usage: UseSystemProxy or NoProxy

ParticipateInCEIP bool

Send anonymous usage information to VMware

CEIPDataTransferProxyPolicy string

Proxy policy for CEIP data transfer