Update-DynDnsRecord

SYNOPSIS

The Update-DynDnsRecord command updates an existing DNS record in the specified zone.

SYNTAX

Update-DynDnsRecord [-DynDnsRecord] <DynDnsRecord> [-UpdatedDynDnsRecord] <DynDnsRecord> [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

The Update-DynDnsRecord command updates an existing DNS record in the specified zone.

Currently, the following DNS record types are supported:

  • A
  • TXT
  • CNAME
  • MX
  • SRV
  • PTR
  • SOA (ResponsiblePerson)

EXAMPLES

Example 1

PS C:\> $DynDnsRecord = Get-DynDnsRecord -Zone anovelidea.org -RecordType A -Node www2
PS C:\> $UpdatedDynDnsRecord = New-DynDnsRecord -IPv4Address 74.125.21.122
PS C:\> Update-DynDnsRecord -DynDnsRecord $DynDnsRecord -UpdatedDynDnsRecord $UpdatedDynDnsRecord -Confirm:$false


Address : 74.125.21.122
Zone    : anovelidea.org
Name    : www2.anovelidea.org
Type    : A
TTL     : 3600

Update the DNS A record for the hostname www2.anovelidea.org.

Example 2

PS C:\> $DynDnsRecord = Get-DynDnsRecord -Zone anovelidea.org -RecordType A -Node www2
PS C:\> $UpdatedDynDnsRecord = New-DynDnsRecord -IPv4Address 74.125.21.122
PS C:\> Update-DynDnsRecord -DynDnsRecord $DynDnsRecord -UpdatedDynDnsRecord $UpdatedDynDnsRecord -Confirm:$false -Verbose
VERBOSE: The original record type matches the updated record type.
VERBOSE:
--------------------------------------------------------------------------------
Original DNS Record:
Address : 74.125.21.121
Zone    : anovelidea.org
Name    : www2.anovelidea.org
Type    : A
TTL     : 3600

VERBOSE:
--------------------------------------------------------------------------------
Update DNS Record Attributes::
Attribute Original      Updated
--------- --------      -------
Address   74.125.21.121 74.125.21.122

--------------------------------------------------------------------------------
VERBOSE: Performing the operation "Update DNS A record" on target "www2.anovelidea.org".
VERBOSE: API-3.7.11 : INFO : BLL : update: Record updated


Address : 74.125.21.122
Zone    : anovelidea.org
Name    : www2.anovelidea.org
Type    : A
TTL     : 3600

Update the DNS A record for the hostname www2.anovelidea.org. Show the original record and the proposed changes.

PARAMETERS

-DynDnsRecord

A DNS record which has previously been published to the zone of any supported type: A, TXT, CNAME, MX, SRV, PTR, SOA.

The value should be created using the Get-DynDnsRecord command.

Type: DynDnsRecord
Parameter Sets: (All)
Aliases:

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

-UpdatedDynDnsRecord

A valid DNS record of the same type as provided by -DynDnsRecord.

The value should be created using the New-DynDnsRecord command.

Type: DynDnsRecord
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the command.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-WhatIf

Shows what would happen if the command runs. The command is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

None

OUTPUTS

DynDnsRecord

NOTES

Add-DynDnsRecord

Get-DynDnsRecord

Update an A Record (API)

Update TXT Record (API)

Update CNAME Records (API)

Update MX Record (API)

Update SRV Records (API)

Update PTR Record (API)

Update SOA Record (API)