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 Windows variabile di 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
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
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.
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.
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
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
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
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
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 è un limite 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
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.
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
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.
Esempio 13: Creare un set di record con un profilo di Gestione traffico (TMLink)
Questo comando crea un oggetto RecordSet denominato www nella zona myzone.com collegato a un profilo Gestione traffico di Azure (TMLink).
Il parametro TrafficManagerProfileId accetta l'ID risorsa ARM completo di un profilo di Gestione traffico.
Si tratta di un set di record vuoto, che funge da segnaposto a cui è possibile aggiungere i record in un secondo momento.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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 altre informazioni, vedere gli esempi.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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"}.
Valore dalla pipeline in base al nome della proprietà:
True
Valore dagli argomenti rimanenti:
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 .
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AliasObject
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-TrafficManagerProfileId
Specifica l'ID completo della risorsa di un profilo di Gestione traffico di Azure per creare un set di record TMLink.
In questo modo il set di record DNS viene collegato a un profilo di Gestione traffico, abilitando le funzionalità di gestione del traffico.
Questo parametro si escludono a vicenda con TargetResourceId.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Zone
Specifica il DnsZone in cui creare l'oggetto RecordSet.
In alternativa, è possibile specificare la zona usando i parametri ZoneName e ResourceGroupName .
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AliasObject
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
TmObject
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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 .
Valore dalla pipeline in base al nome della proprietà:
True
Valore dagli argomenti rimanenti:
False
AliasFields
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
True
Valore dagli argomenti rimanenti:
False
TmFields
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
True
Valore dagli argomenti rimanenti:
False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
È 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 PowerShell $ConfirmPreference Windows 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.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.