< Back

Add-GcdChange

Mon Jan 13, 2020 10:55 pm

NAME Add-GcdChange



SYNOPSIS

Add a new Change to a ManagedZone of a Project.





SYNTAX

Add-GcdChange [-Project <string>] [-Zone] <string> [-ChangeRequest] <Change> [<CommonParameters>]



Add-GcdChange [-Project <string>] [-Zone] <string> [-Add <ResourceRecordSet[]>] [-Remove <ResourceRecordSet[]>]

[<CommonParameters>]





DESCRIPTION

Create, execute, and return a new Change request within a specified ManagedZone of a Project.



If a Project is specified, will instead create the Change in the specified ManagedZone governed by that project.

Either a Change request or ResourceRecordSet[] to add/remove can be given as input.





PARAMETERS

-Project <string>

Get the Project to change.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Zone <string>

Get the ManagedZone (name or id permitted) to change.



Required? true

Position? 0

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ManagedZone <string>

Get the ManagedZone (name or id permitted) to change.



This is an alias of the Zone parameter.



Required? true

Position? 0

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ChangeRequest <Change>

Get the Change request to execute.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Change <Change>

Get the Change request to execute.



This is an alias of the ChangeRequest parameter.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Add <ResourceRecordSet[]>

Get the ResourceRecordSet(s) to add for this Change.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Remove <ResourceRecordSet[]>

Get the ResourceRecordSet(s) to remove (must exactly match existing ones) for this Change.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Rm <ResourceRecordSet[]>

Get the ResourceRecordSet(s) to remove (must exactly match existing ones) for this Change.



This is an alias of the Remove parameter.



Required? false

Position? named

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

Google.Apis.Dns.v1.Data.Change

Get the Change request to execute.





OUTPUTS

Google.Apis.Dns.v1.Data.Change





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



$newARecord = New-GcdResourceRecordSet -Name "gcloudexample1.com." `

-Rrdata "104.1.34.167"

$oldCNAMERecord = (Get-GcdResourceRecordSet -Zone "test1" -Filter "CNAME")[0]

Add-GcdChange -Project "proj" -Zone "test1" `

-Add $newARecord -Remove $oldCNAMERecord



Add a new Change that adds a new A-type ResourceRecordSet, $newARecord, and removes an existing CNAME-type record,

$oldCNAMERecord, from the ManagedZone "test1" (governing "gcloudexample1.com.") in the Project "testing."

---------- EXAMPLE 2 ----------



PS C:\\> $change2 = Get-GcdChange -Project "testing" -Zone "test1" -ChangeId 2

PS C:\\> Add-GcdChange -Project "proj" -Zone "test1" -ChangeRequest $change2



Add the Change request $change2 to the ManagedZone "test1" in the Project "testing," where $change2 is a

previously executed Change request in ManagedZone "test1" that we want to apply again.



RELATED LINKS

[Monitoring Changes] (https://cloud.google.com/dns/monitoring)

[Troubleshooting] (https://cloud.google.com/dns/troubleshooting)