New-AzDnsRecordConfig

Modulo:

Az.Dns

Crea un nuovo oggetto locale del record DNS.

Sintassi

New-AzDnsRecordConfig
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Flags <UInt16>
   -Order <UInt16>
   -Preference <UInt16>
   -Services <String>
   -Regexp <String>
   -Replacement <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzDnsRecordConfig crea un oggetto dnsRecord locale. Una matrice di questi oggetti viene passata al cmdlet New-AzDnsRecordSet usando il parametro DnsRecords per specificare i record da creare nel set di record.

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 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 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 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 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 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 "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Questo comando crea un 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 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 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 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 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 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 myzone.com della zona. 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 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 testo denominato 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 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 di tipo DS

$Records = @()
$Records += New-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "childds" -RecordType DS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Questo comando crea un oggetto RecordSet denominato childds nella zona myzone.com. Il set di record è di tipo DS e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. I dati del record contengono il tag chiave, l'algoritmo, il tipo di digest e il digest del record DNSKEY della zona figlio. Per creare un 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 oggetto RecordSet di tipo TLSA

$Records = @()
$Records += New-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Questo comando crea un RecordSet denominato _443._tcp.www nella zona myzone.com. Il set di record è di tipo TLSA e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. I dati del record contengono l'utilizzo, il selettore e il tipo corrispondente dei dati dell'associazione di certificati. Per creare un 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 oggetto RecordSet di tipo NAPTR

$Records = @()
$Records += New-AzDnsRecordConfig -Flags 0 -Order 100 -Preference 100 -Services "SIP+D2U" -Regexp "" -Replacement "example.com"
$RecordSet = New-AzDnsRecordSet -Name "naptr123" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Questo comando crea un RecordSet denominato naptr123 nella zona myzone.com. Il set di record è di tipo NAPTR e ha un TTL di 1 ora (3600 secondi). Contiene un singolo record DNS. I dati del record contengono i campi ordine, preferenza, flag, servizi, regexp e sostituzione. Per creare un RecordSet usando una sola riga di pn_PowerShell_short o per creare un set di record con più record, vedere l'esempio 1.

Parametri

-Algorithm

Campo dell'algoritmo del record DS da aggiungere.

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

-CaaFlags

Flag per il record CAA da aggiungere. Deve essere un numero compreso tra 0 e 255.

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

-CaaTag

Campo tag del record CAA da aggiungere.

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

-CaaValue

Campo valore per il record CAA da aggiungere.

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

-CertificateAssociationData

Campo dei dati dell'associazione di certificati del record TLSA da aggiungere.

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

-Cname

Specifica il nome di dominio per un record CNAME (Canonical Name).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
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

-Digest

Campo digest del record DS da aggiungere.

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

-DigestType

Campo del tipo di digest del record DS da aggiungere.

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

-Exchange

Specifica il nome del server di scambio di posta per un record MX (Mail Exchange).

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

-Flags

Specifica i flag per un record NAPTR.

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

-Ipv4Address

Specifica un indirizzo IPv4 per un record A.

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

-Ipv6Address

Specifica un indirizzo IPv6 per un record AAAA.

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

-KeyTag

Campo del tag chiave del record DS da aggiungere.

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

-MatchingType

Campo del tipo corrispondente del record TLSA da aggiungere.

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

-Nsdname

Specifica il nome del server dei nomi per un record NS (Name Server).

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

-Order

Specifica l'ordine di un record NAPTR.

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

-Port

Specifica la porta per un record SRV (Service).

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

-Preference

Specifica la preferenza per un record MX/NAPTR.

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

-Priority

Specifica la priorità per un record SRV.

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

-Ptrdname

Specifica il nome di dominio di destinazione di un record ptr (pointer resource).

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

-Regexp

Specifica il regexp per un record NAPTR.

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

-Replacement

Specifica la sostituzione di un record NAPTR.

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

-Selector

Campo del selettore del record TLSA da aggiungere.

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

-Services

Specifica i servizi per un record NAPTR.

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

-Target

Specifica la destinazione per un record SRV.

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

-Usage

Campo di utilizzo del record TLSA da aggiungere.

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

-Value

Specifica il valore per un record TXT.

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

-Weight

Specifica il peso per un record SRV.

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

Input

String

UInt16

Byte

Output

DnsRecordBase

Collegamenti correlati

• Add-AzDnsRecordConfig
• New-AzDnsRecordSet
• Remove-AzDnsRecordConfig