Connect-VCAVExtend

NAME Connect-VCAVExtend



SYNOPSIS

Connect-VCAVExtend extends the current vCloud Availability session to

additional VCAV sites.





SYNTAX

Connect-VCAVExtend [-VCAVSiteName] <String> [-VCDHost] <String> [<CommonParameters>]





DESCRIPTION

Connect-VCAVExtend uses the session secret of an existing vCloud Director

connections (obtained from Connect-CIServer) to extend the VCAV session to

additional sites. The VCAV Site Name and VCD host to be extended to must

be specified. The extended session is persisted in session variables for use

by other commands in this module (e.g. Invoke-VCAVQuery).





PARAMETERS

-VCAVSiteName <String>



Required? true

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-VCDHost <String>

A required parameter containing The API endpoint for vCloud Director at the

site to be extended to, typically this will be the public URI for the vCloud

Director instance.



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

A status message (success or failure) is given for the connection extension

attempt.





NOTES





The host name specified for the VCDHost must match the name used when the

original Connect-CIServer command was issued so that the correct session can be

located in the $Global:DefaultCIServers array. A list of valid VCAV site names

can be obtained using the Invoke-VCAVQuery cmdlet with -QueryPath of 'sites'.



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Connect-VCAVExtend -VCAVSiteName 'Site2' -VCDHost 'vcdsite2.cloud.com'















RELATED LINKS