< Back
Add-GcdChange
Post
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)
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)