New-AzDnsRecordSet

Sintaxe

New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzDnsRecordSet cria um novo conjunto de registros DNS (Sistema de Nomes de Domínio) com o nome e o tipo especificados na zona especificada. Um objeto RecordSet é um conjunto de registros DNS com o mesmo nome e tipo. Observe que o nome é relativo à zona e não ao nome totalmente qualificado. O parâmetro DnsRecords especifica os registros no conjunto de registros. Esse parâmetro usa uma matriz de registros DNS, construídos usando New-AzDnsRecordConfig. Você pode usar o operador de pipeline para passar um objeto DnsZone para esse cmdlet ou passar um objeto DnsZone como o parâmetro Zone ou, como alternativa, você pode especificar a zona pelo nome. Você pode usar o parâmetro Confirmar e $ConfirmPreference variável do Windows PowerShell para controlar se o cmdlet solicita confirmação. Se já existir um RecordSet correspondente (mesmo nome e tipo de registro), você deverá especificar o parâmetro Substituir, caso contrário, o cmdlet não criará um novo RecordSet.

Exemplos

Exemplo 1: Criar um Conjunto de Registros do tipo A

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)

# To create a record set containing multiple records, use New-AzDnsRecordConfig to add each record to the $Records array,
# then call New-AzDnsRecordSet, as follows:

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este exemplo cria um do RecordSet denominado www na myzone.com de zona. O conjunto de registros é do tipo A e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS.

Exemplo 2: Criar um Conjunto de Registros do tipo AAAA

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este exemplo cria um do RecordSet denominado www na myzone.com de zona. O conjunto de registros é do tipo AAAA e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 3: Criar um Conjunto de Registros do tipo CNAME

$Records = @()
$Records += New-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este exemplo cria um do RecordSet denominado www na myzone.com de zona. O conjunto de registros é do tipo CNAME e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 4: Criar um Conjunto de Registros do tipo MX

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria um do RecordSet denominado www no myzone.com de zona. O conjunto de registros é do tipo MX e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 5: Criar um Conjunto de Registros do tipo NS

$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria um do RecordSet denominado ns1 no myzone.com de zona. O conjunto de registros é do tipo NS e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 6: Criar um Conjunto de Registros do tipo PTR

$Records = @()
$Records += New-AzDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -DnsRecords $Records

Esse comando cria um RecordSet denominado 4 na zona 3.2.1.in-addr.arpa. O conjunto de registros é do tipo PTR e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 7: Criar um Conjunto de Registros do tipo SRV

$Records = @()
$Records += New-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria uma RecordSet chamada _sip._tcp no myzone.com de zona. O conjunto de registros é do tipo SRV e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS, apontando para o endereço IP 2001.2.3.4. O serviço (sip) e o protocolo (tcp) são especificados como parte do nome do conjunto de registros, não como parte dos dados de registro. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 8: Criar um Conjunto de Registros do tipo TXT

$Records = @()
$Records += New-AzDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria um texto nomeado no myzone.com de zona. O conjunto de registros é do tipo TXT e tem um TTL de 1 hora (3600 segundos). Ele contém um único registro DNS. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 9: Criar um RecordSet no ápice da zona

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria um RecordSet no ápice (ou raiz) do myzone.com de zona. Para fazer isso, o nome do conjunto de registros é especificado como "@" (incluindo as aspas duplas). Não é possível criar registros CNAME no ápice de uma zona. Essa é uma restrição dos padrões DNS; não é uma limitação do DNS do Azure. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 10: Criar um conjunto de registros curinga

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Esse comando cria um RecordSet chamado * no myzone.com de zona. Este é um conjunto de registros curinga. Para criar um RecordSet usando apenas uma linha de pn_PowerShell_short ou para criar um conjunto de registros com vários registros, consulte o Exemplo 1.

Exemplo 11: Criar um conjunto de registros vazio

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()

Esse comando cria um do RecordSet denominado www no myzone.com de zona. O conjunto de registros é do tipo A e tem um TTL de 1 hora (3600 segundos). Esse é um conjunto de registros vazio, que atua como um espaço reservado ao qual você pode adicionar registros posteriormente.

Exemplo 12: Criar um conjunto de registros e suprimir toda a confirmação

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

Esse comando cria umRecordSet. O parâmetro Substituir garante que esse conjunto de registros substitua qualquer conjunto de registros pré-existente com o mesmo nome e tipo (os registros existentes nesse conjunto de registros são perdidos). O parâmetro Confirme com um valor de $False suprime o prompt de confirmação.

Parâmetros

-Confirm

-DefaultProfile

-DnsRecords

-Metadata

-Name

-Overwrite

-RecordType

-ResourceGroupName

-TargetResourceId

-Ttl

-WhatIf

-Zone

-ZoneName

Entradas

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Saídas

DnsRecordSet

Observações

Você pode usar o parâmetro Confirmar para controlar se esse cmdlet solicita confirmação. Por padrão, o cmdlet solicitará confirmação se a variável $ConfirmPreference Windows PowerShell tiver um valor médio ou inferior. Se você especificar Confirmar ou Confirm:$True, esse cmdlet solicitará a confirmação antes de ser executado. Se você especificar Confirm:$False, o cmdlet não solicitará confirmação.

Links Relacionados

• Add-AzDnsRecordConfig
• Get-AzDnsRecordSet
• New-AzDnsRecordConfig
• Remove-AzDnsRecordSet
• Set-AzDnsRecordSet