New-AzDnsRecordSet

Crea un set di record DNS.

Sintassi

Fields (Impostazione predefinita)

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

AliasFields

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

TmFields

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

Object

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

AliasObject

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

TmObject

New-AzDnsRecordSet
    -Name <String>
    -Zone <DnsZone>
    -Ttl <UInt32>
    -RecordType <RecordType>
    -TrafficManagerProfileId <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 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

$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 è 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

$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.

Esempio 13: Creare un set di record con un profilo di Gestione traffico (TMLink)

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Ttl 3600 -TrafficManagerProfileId "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myprofile"

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.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
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.

Proprietà dei parametri

Tipo:

DnsRecordBase[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
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"}.

Proprietà dei parametri

Tipo:Hashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome dell'oggetto RecordSet da creare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Overwrite

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • I record SOA TXT vengono creati automaticamente quando viene creata la zona e non possono essere creati manualmente.

Proprietà dei parametri

Tipo:RecordType
Valore predefinito:None
Valori accettati:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
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 .

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Fields
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
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

-TargetResourceId

ID risorsa di destinazione alias.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AliasFields
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

TmFields
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
TmObject
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Ttl

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

Proprietà dei parametri

Tipo:UInt32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Fields
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
Object
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
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 .

Proprietà dei parametri

Tipo:DnsZone
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Object
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
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 .

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Fields
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
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.

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