< Back

ConvertTo-GcSqlInstance

Mon Jan 13, 2020 11:05 pm

NAME ConvertTo-GcSqlInstance



SYNOPSIS

Convert a Cloud SQL Replica to an SQL Instance.





SYNTAX

ConvertTo-GcSqlInstance [-Project <string>] [-Replica] <string> [<CommonParameters>]



ConvertTo-GcSqlInstance [-ReplicaObject] <DatabaseInstance> [<CommonParameters>]





DESCRIPTION

Convert the specified Cloud SQL Replica to a stand-alone Instance.



If a Project is specified, it will promote the specified Replica in that Project. Otherwise, promotes the replica

in the Cloud SDK config project.





PARAMETERS

-Project <string>

Name of the project in which the instance Replica resides. Defaults to the Cloud SDK config for properties if

not specified.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Replica <string>

The name/ID of the Replica resource to promote.



Required? true

Position? 0

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ReplicaObject <DatabaseInstance>

The DatabaseInstance that describes the Replica we want to promote.



Required? true

Position? 0

Default value

Accept pipeline input? true (ByValue)

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

Google.Apis.SQLAdmin.v1beta4.Data.DatabaseInstance

The DatabaseInstance that describes the Replica we want to promote.





OUTPUTS



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



PS C:\\> ConvertTo-GcSqlInstance -Project "testing" -Replica "testRepl1"



Convert the SQL Replica "testRepl1" from the Project "testing."



RELATED LINKS

[Replica Instances] (https://cloud.google.com/tools/powershe ... ql/replica)