New-AzureDns
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
New-AzureDns
Creates a DNS settings object to be used when creating an Azure deployment.
Syntax
Parameter Set: Default
New-AzureDns [-Name] <String> [-IPAddress] <String> [ <CommonParameters>]
Detailed Description
This topic describes the cmdlet in the 0.8.10 version of the Microsoft Azure PowerShell module. To get the version of the module you're using, in the Azure PowerShell console, type (Get-Module -Name Azure).Version.
The New-AzureDNS cmdlet creates a DNS settings object for use by the New-AzureVM cmdlet. It accepts two parameters: Name and IPAddress. The Name parameter is a friendly name, not necessarily a DNS resolvable name, and the IPAddress parameter is the IP address of the DNS server.
Parameters
-IPAddress<String>
Specifies the IP address of the DNS server.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a friendly name to identify the DNS server. This name is not necessarily a fully qualified domain name.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
-------------- Example 1 --------------
This command creates a new Azure DNS settings object.
C:\PS>$dns1 = New-AzureDns –Name "dns1" –IPAddress "10.1.2.4"
-------------- Example 2 --------------
This command creates a new Azure DNS settings object that is then used during the creation of a virtual machine with the New-AzureVM cmdlet.
C:\PS>$dns1 = New-AzureDns –Name "dns1" –IPAddress "10.1.2.4"
C:\PS>New-AzureVM –ServiceName $MyService –AffinityGroup $MyAG –VnetName $VNet1 –DnsSettings $dns1 –VMs $MyVMconfig