< Back

Remove-DynDnsNode

Sat Jan 18, 2020 8:16 pm

NAME Remove-DynDnsNode



SYNOPSIS

The command Remove-DynDnsNode removes the indicated node, any records within the node, and any nodes underneath

the node.





SYNTAX

Remove-DynDnsNode [-Zone] <String> [-Node] <String> [-Confirm] [-Force] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The command Remove-DynDnsNode removes the indicated node, any records within the node, and any nodes underneath

the node. NOTE: Use this method ONLY for cleaning up a zone. Regular node or record deletes should use the Delete

A Records (API) method. Once all node records are removed, the node is automatically removed.





PARAMETERS

-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the command.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Force [<SwitchParameter>]

The -Force switch is required if the node contains any records or other nodes. When provided, it will allow

the deletion of the node and all records and nodes it contains.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Node <String>

A node in the specified zone. If the node does not end with the domain of the zone, it will be appended.



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

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



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Zone <String>

The zone in which to delete the specified node, records, and child nodes.



Required? true

Position? 0

Default value None

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

None







OUTPUTS

None







NOTES









--------------------------- Example ---------------------------



PS C:\\> Remove-DynDnsNode -Zone anovelidea.org -Node newnode.anovelidea.org

WARNING: The node (newnode.anovelidea.org) contains records or services. Use the -Force switch if you wish to

proceed.



PS C:\\> Remove-DynDnsNode -Zone anovelidea.org -Node newnode.anovelidea.org -Force





--------------------------------------------------------------------------------

PROCEEDING WILL DELETE ALL RECORDS AND SERVICES CONTAINED WITHIN THE NODE

THIS INCLUDES ALL CHILD NODES

--------------------------------------------------------------------------------



Zone records for newnode.anovelidea.org:

----------------------------------------

Strings : {NewTest}

Zone : anovelidea.org

Name : newnode.anovelidea.org

Type : TXT

TTL : 3600



Address : 127.0.0.1

Zone : anovelidea.org

Name : newnode.anovelidea.org

Type : A

TTL : 3600



--------------------------------------------------------------------------------







Confirm

Are you sure you want to perform this action?

Performing the operation "Delete node, child nodes, and all records" on target "newnode.anovelidea.org".

[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y



Remove the node newnode.anovelidea.org from the zone anovelidea.org. The example illustrates that the -Force

switch must be used if the node contains any records or child nodes.



RELATED LINKS

Online Version: https://powershell.anovelidea.org/modul ... sNode.html

Get-DynDnsNodeList https://powershell.anovelidea.org/modul ... eList.html

Delete Zone Node (API) https://help.dyn.com/delete-zone-node-api/