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> [-Force] [-WhatIf] [-Confirm] [<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.
EXAMPLES
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.
PARAMETERS
-Zone
The zone in which to delete the specified node, records, and child nodes.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Node
A node in the specified zone. If the node does not end with the domain of the zone, it will be appended.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
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.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
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).