New-DynDnsRecord

NAME New-DynDnsRecord



SYNOPSIS

The New-DynDnsRecord creates DNS record object of the specified type.





SYNTAX

New-DynDnsRecord -CName <String> [-TTL <Int32>] [<CommonParameters>]



New-DynDnsRecord -IPv4Address <IPAddress> [-TTL <Int32>] [<CommonParameters>]



New-DynDnsRecord -MailServer <String> -Preference <String> [-TTL <Int32>] [<CommonParameters>]



New-DynDnsRecord -Port <Int32> -Priority <Int32> [-TTL <Int32>] -Target <String> -Weight <Int32>

[<CommonParameters>]



New-DynDnsRecord -ResponsiblePerson <String> [-TTL <Int32>] [<CommonParameters>]



New-DynDnsRecord [-TTL <Int32>] -Text <String> [<CommonParameters>]





DESCRIPTION

The New-DynDnsRecord creates DNS record object of the specified type.



The object can be used by Add-DynDnsRecord and Update-DynDnsRecord and other commands.



The output depends on the DNS record type and can be any of the following:



* A



* TXT



* CNAME



* MX



* SRV



* PTR



* SOA (ResponsiblePerson)





The Zone and Name properties are populated when returning objects from the service.







PARAMETERS

-CName <String>

Specifies the alias, i.e. fully-qualified domain name, of the zone node.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-IPv4Address <IPAddress>

Specifies the IP address.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-MailServer <String>

Specifies a mail server that processes mail for the domain.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Port <Int32>

Specifies the TCP or UDP port on which the service is to be found.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Preference <String>

Specifies the preference value used to prioritize mail delivery if multiple mail servers are available.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Priority <Int32>

Specifies the priority of the target host, lower value means more preferred.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ResponsiblePerson <String>

Specifies the email address of the domain name administrator.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-TTL <Int32>

The Time-To-Live (TTL) to be used for the the DNS record.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Target <String>

Specifies the canonical hostname of the machine providing the service.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Text <String>

Specifies a string of abritrary text.



This is typically used to set the Sender Policy Framework (SPF) record or prove ownership of the zone to a

third-party.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Weight <Int32>

Specifies the relative weight for records with the same priority, higher value means more preferred.



Required? true

Position? named

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

DynDnsRecord







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> New-DynDnsRecord -IPv4Address 172.16.30.9





Address : 172.16.30.9

Zone :

Name :

Type : A

TTL : 0



Create a DynDnsRecord_A object.

-------------------------- Example 2 --------------------------



PS C:\\> New-DynDnsRecord -Text 'Authorization text'





Strings : {Authorization text}

Zone :

Name :

Type : TXT

TTL : 0



Create a DynDnsRecord_TXT object.

-------------------------- Example 3 --------------------------



PS C:\\> New-DynDnsRecord -Target chat.anovelidea.org -Port 443 -Priority 10 -Weight 100





Target : chat.anovelidea.org

Port : 443

Priority : 10

Weight : 100

Zone :

Name :

Type : SRV

TTL : 0



Create a DynDnsRecord_SRV object.



RELATED LINKS

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