Skip to content

Connect-CloudBuilder

Synopsis

Requests an authentication token from a VMware Cloud Builder instance.

Syntax

Connect-CloudBuilder [-fqdn] <String> [[-username] <String>] [[-password] <String>] [[-credential] <PSCredential>] [-skipCertificateCheck] [<CommonParameters>]

Description

The Connect-CloudBuilder cmdlet connects to the specified VMware Cloud Builder instance and stores the credentials in a base64 string.

Note

It is required once per session before running all other cmdlets.

Examples

Example 1

Connect-CloudBuilder -fqdn sfo-cb01.sfo.rainpole.io -username admin -password VMw@re1!

This example shows how to connect to the specified VMware Cloud Builder instance using a clear-text username and password.

Example 2

$secureString = Read-Host -AsSecureString 'Password'
Connect-CloudBuilder -fqdn sfo-cb01.sfo.rainpole.io -username admin -password $secureString

This example shows how to connect to the specified VMware Cloud Builder instance using a SecureString password.

Example 3

$credential = Get-Credential
Connect-CloudBuilder -fqdn sfo-cb01.sfo.rainpole.io -credential $credential

This example shows how to connect to the specified VMware Cloud Builder instance using a PSCredential.

Example 4

Connect-CloudBuilder -fqdn sfo-cb01.sfo.rainpole.io -username admin

This example shows how to connect to the specified VMware Cloud Builder instance where the user will be prompted for a password.

Example 5

Connect-CloudBuilder -fqdn sfo-cb01.sfo.rainpole.io

This example shows how to connect to the specified VMware Cloud Builder instance where the user will be prompted for a username and password.

Parameters

-fqdn

The fully qualified domain name of the VMware Cloud Builder instance.

Type: String
Parameter Sets: PSCredentialSet, UserNameAndPasswordSet
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-username

The username to authenticate to the VMware Cloud Builder instance.

Type: String
Parameter Sets: UserNameAndPasswordSet
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-password

The password to authenticate to the VMware Cloud Builder instance. This parameter takes either a string or a SecureString value.

If not specified, the user will be prompted for the SecureString value.

Type: String
Parameter Sets: UserNameAndPasswordSet
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-credential

Specifies to authenticate to the SDDC Manager instance using a PSCredential object.

Type: PSCredential
Parameter Sets: PSCredentialSet
Aliases:

Required: True
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-skipCertificateCheck

Switch to skip certificate check when connecting to the VMware Cloud Builder instance.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Common Parameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.