Condividi tramite


Add-AzPrivateDnsRecordConfig

Aggiunge un record DNS privato a un oggetto set di record locale.

Sintassi

Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzPrivateDnsRecordConfig
   -RecordSet <PSPrivateDnsRecordSet>
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzPrivateDnsRecordConfig aggiunge un record DNS (Domain Name System) privato a un oggetto RecordSet. L'oggetto RecordSet è un oggetto offline e le modifiche apportate non modificano le risposte DNS private fino a quando non si esegue il cmdlet Set-AzPrivateDnsRecordSet per rendere persistente la modifica al servizio DNS privato di Microsoft Azure. I record SOA vengono creati quando viene creata una zona DNS privato e vengono rimossi quando viene eliminata la zona DNS privato. Non è possibile aggiungere o rimuovere record SOA, ma è possibile modificarli. È possibile passare l'oggetto RecordSet a questo cmdlet come parametro o usando l'operatore pipeline.

Esempio

Esempio 1: Aggiungere un record A a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record A a un set di record esistente.

Esempio 2: Aggiungere un record AAAA a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name www -RecordType AAAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name www -RecordType AAAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {2001:DB80:4009:1803::1005}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record AAAAA a un set di record esistente.

Esempio 3: Aggiungere un record CNAME a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Cname contoso.com | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record CNAME a un set di record esistente.

Esempio 4: Aggiungere un record MX a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {[5,mail.microsoft.com]}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record MX a un set di record esistente.

Esempio 5: Aggiungere un record PTR a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa
Add-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa | Add-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {www.contoso.com}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record PTR a un set di record esistente.

Esempio 6: Aggiungere un record SRV a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {[0,5,8080,sipservice.contoso.com]}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record SRV a un set di record esistente.

Esempio 7: Aggiungere un record TXT a un set di record

$RecordSet = Get-AzPrivateDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzPrivateDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzPrivateDnsRecordConfig -Value "This is a TXT Record" | Set-AzPrivateDnsRecordSet

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {This is a TXT Record}
Metadata          :
IsAutoRegistered  :

In questo esempio viene aggiunto un record TXT a un set di record esistente.

Parametri

-Cname

Nome canonico per il record CNAME da aggiungere. Non deve essere relativo al nome della zona. Non deve avere un punto di terminazione

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
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

-Exchange

Host di scambio di posta per il record MX da aggiungere. Non deve essere relativo al nome della zona. Non deve avere un punto di terminazione

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

-Ipv4Address

Indirizzo IPv4 per il record A da aggiungere.

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

-Ipv6Address

Indirizzo IPv6 per il record AAAA da aggiungere.

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

-Port

Numero di porta per il record SRV da aggiungere.

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

-Preference

Valore preferenza per il record MX da aggiungere.

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

-Priority

Valore di priorità record SRV da aggiungere.

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

-Ptrdname

Host di destinazione per il record PTR da aggiungere. Non deve essere relativo al nome della zona. Non deve avere un punto di terminazione

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

-RecordSet

Set di record in cui aggiungere il record.

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

-Target

Host di destinazione per il record SRV da aggiungere. Non deve essere relativo al nome della zona. Non deve avere un punto di terminazione

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

-Value

Valore di testo da aggiungere per il record TXT.

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

-Weight

Valore di peso per il record SRV da aggiungere.

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

Input

Output