Condividi tramite


Remove-AzDnsRecordConfig

Rimuove un record DNS da un oggetto set di record locale.

Sintassi

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzDnsRecordConfig rimuove un record DNS (Domain Name System) da un set di record. L'oggetto RecordSet è un oggetto offline e le modifiche apportate non modificano le risposte DNS fino a quando non si esegue il cmdlet Set-AzDnsRecordSet per rendere persistente la modifica al servizio DNS di Microsoft Azure. Per rimuovere un record, tutti i campi per quel tipo di record devono corrispondere esattamente. Non è possibile aggiungere o rimuovere record SOA. I record SOA vengono creati automaticamente quando viene creata una zona DNS ed eliminati automaticamente quando viene eliminata la zona DNS. È possibile passare l'oggetto RecordSet a questo cmdlet come parametro o usando l'operatore pipeline.

Esempio

Esempio 1: Rimuovere un record A da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

In questo esempio viene rimosso un record A da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato sarà un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 2: Rimuovere un record AAAA da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

In questo esempio viene rimosso un record AAAA da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato sarà un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 3: Rimuovere un record CNAME da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

In questo esempio viene rimosso un record CNAME da un set di record esistente. Poiché un set di record CNAME può contenere al massimo un record, il risultato è un set di record vuoto.

Esempio 4: Rimuovere un record MX da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

In questo esempio viene rimosso un record MX da un set di record esistente. Il nome del record "@" indica un set di record al vertice della zona. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 5: Rimuovere un record NS da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

In questo esempio viene rimosso un record NS da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 6: Rimuovere un record PTR da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

In questo esempio viene rimosso un record PTR da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 7: Rimuovere un record SRV da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

In questo esempio viene rimosso un record SRV da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 8: Rimuovere un record TXT da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

In questo esempio viene rimosso un record TXT da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 9: Rimuovere un record DS da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

In questo esempio viene rimosso un record DS da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Esempio 10: Rimuovere un record TLSA da un set di record

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

In questo esempio viene rimosso un record TLSA da un set di record esistente. Se si tratta dell'unico record nel set di record, il risultato è un set di record vuoto. Per rimuovere completamente un set di record, vedere Remove-AzDnsRecordSet.

Parametri

-Algorithm

Campo dell'algoritmo del record DS da rimuovere.

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 dati dell'associazione di certificati del record TLSA da rimuovere.

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

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

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

-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 tag chiave del record DS da rimuovere.

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

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

-Nsdname

Specifica il 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

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

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 del puntatore (PTR).

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

-RecordSet

Specifica l'oggetto RecordSet che contiene il record da rimuovere.

Tipo:DnsRecordSet
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 rimuovere.

Tipo:Int32
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 rimuovere.

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

DnsRecordSet

String

UInt16

Byte

Output

DnsRecordSet