Condividi tramite

New-AzDnsRecordSet

  • Riferimento
Modulo:
Az.Dns

Crea un set di record DNS.

Sintassi

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>]

Descrizione

Il cmdlet New-AzDnsRecordSet crea un nuovo set di record DNS (Domain Name System) con il nome e il tipo specificati nella zona specificata. Un oggetto RecordSet è un set di record DNS con lo stesso nome e tipo. Si noti che il nome è relativo alla zona e non al nome completo. Il parametro DnsRecords specifica i record nel set di record. Questo parametro accetta una matrice di record DNS, costruiti usando New-AzDnsRecordConfig. È possibile usare l'operatore pipeline per passare un oggetto DnsZone a questo cmdlet oppure passare un oggetto DnsZone come parametro Zone oppure in alternativa è possibile specificare la zona in base al nome. È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma. Se esiste già un oggetto RecordSet corrispondente (stesso nome e tipo di record), è necessario specificare il parametro Overwrite. In caso contrario, il cmdlet non creerà un nuovo oggetto RecordSet.

Esempio

Esempio 1: Creare un oggetto RecordSet di 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

In questo esempio viene creato un oggetto RecordSet denominato www nella zona myzone.com. Il set di record è di tipo A e ha un valore TTL di 1 ora (3600 secondi). Contiene un singolo record DNS.

Esempio 2: Creare un oggetto RecordSet di 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

In questo esempio viene creato un oggetto RecordSet denominato www nella zona myzone.com. Il set di record è di tipo AAAA e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 3: Creare un oggetto RecordSet di 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

In questo esempio viene creato un oggetto RecordSet denominato www nella zona myzone.com. Il set di record è di tipo CNAME e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 4: Creare un oggetto RecordSet di 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

Questo comando crea un oggetto RecordSet denominato www nella zona myzone.com. Il set di record è di tipo MX e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 5: Creare un oggetto RecordSet di 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

Questo comando crea un oggetto RecordSet denominato ns1 nella zona myzone.com. Il set di record è di tipo NS e ha una durata TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 6: Creare un oggetto RecordSet di 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

Questo comando crea un oggetto RecordSet denominato 4 nella zona 3.2.1.in-addr.arpa. Il set di record è di tipo PTR e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 7: Creare un oggetto RecordSet di 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

Questo comando crea un oggetto RecordSet denominato _sip._tcp nella zona myzone.com. Il set di record è di tipo SRV e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS, che punta all'indirizzo IP 2001.2.3.4. Il servizio (sip) e il protocollo (tcp) vengono specificati come parte del nome del set di record, non come parte dei dati del record. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 8: Creare un oggetto RecordSet di 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

Questo comando crea un oggetto RecordSet denominato text nell'area myzone.com. Il set di record è di tipo TXT e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 9: Creare un oggetto RecordSet al vertice della 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

Questo comando crea un oggetto RecordSet al vertice (o alla radice) della zona myzone.com. A tale scopo, il nome del set di record viene specificato come "@" (incluse le virgolette doppie). Non è possibile creare record CNAME al vertice di una zona. Si tratta di un vincolo degli standard DNS; non è una limitazione di DNS di Azure. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 10: Creare un set di record con caratteri jolly

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

Questo comando crea un oggetto RecordSet denominato * nella zona myzone.com. Si tratta di un set di record con caratteri jolly. Per creare un oggetto RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Esempio 11: Creare un set di record vuoto

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

Questo comando crea un oggetto RecordSet denominato www nella zona myzone.com. Il set di record è di tipo A e ha un valore TTL di 1 ora (3600 secondi). Si tratta di un set di record vuoto, che funge da segnaposto a cui è possibile aggiungere i record in un secondo momento.

Esempio 12: Creare un set di record e eliminare tutte le conferme

$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

Questo comando crea un oggetto RecordSet. Il parametro Overwrite garantisce che questo set di record sovrascriva qualsiasi set di record preesistente con lo stesso nome e tipo (i record esistenti nel set di record andranno persi). Il parametro Confirm con valore $False elimina la richiesta di conferma.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DnsRecords

Specifica la matrice di record DNS da includere nel set di record. È possibile usare il cmdlet New-AzDnsRecordConfig per creare oggetti record DNS. Per ulteriori informazioni, vedere gli esempi.

Tipo:DnsRecordBase[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Metadata

Specifica una matrice di metadati da associare all'oggetto RecordSet. I metadati vengono specificati usando coppie nome-valore rappresentate come tabelle hash, ad esempio @{"dept"="shopping";" env"="production"}.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome dell'oggetto RecordSet da creare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Overwrite

Indica che questo cmdlet sovrascrive l'oggetto RecordSet specificato, se esiste già.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RecordType

Specifica il tipo di record DNS da creare. I valori validi sono:

  • Un
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • I record SOA TXT vengono creati automaticamente quando viene creata la zona e non possono essere creati manualmente.
Tipo:RecordType
Valori accettati:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Specifica il gruppo di risorse che contiene la zona DNS. È inoltre necessario specificare il parametro ZoneName per specificare il nome della zona. In alternativa, è possibile specificare la zona e il gruppo di risorse passando un oggetto Zona DNS usando il parametro Zone .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-TargetResourceId

ID risorsa di destinazione alias.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Ttl

Specifica la durata (TTL) per l'oggetto RecordSet DNS.

Tipo:UInt32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Zone

Specifica il DnsZone in cui creare l'oggetto RecordSet. In alternativa, è possibile specificare la zona usando i parametri ZoneName e ResourceGroupName .

Tipo:DnsZone
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ZoneName

Specifica il nome della zona in cui creare l'oggetto RecordSet. È inoltre necessario specificare il gruppo di risorse contenente la zona usando il parametro ResourceGroupName . In alternativa, è possibile specificare la zona e il gruppo di risorse passando un oggetto Zona DNS usando il parametro Zone .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Output

DnsRecordSet

Note

È possibile usare il parametro Confirm per controllare se questo cmdlet richiede la conferma. Per impostazione predefinita, il cmdlet richiede la conferma se la variabile di Windows PowerShell $ConfirmPreference ha un valore medio o inferiore. Se si specifica Confirm o Confirm:$True, questo cmdlet richiede la conferma prima dell'esecuzione. Se si specifica Confirm:$False, il cmdlet non richiede la conferma.