Condividi tramite

Remove-AzDnsRecordSet

  • Riferimento
Modulo:
Az.Dns

Elimina un set di record.

Sintassi

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzDnsRecordSet elimina il set di record specificato dalla zona specificata. Non è possibile eliminare record SOA o name server (NS) creati automaticamente al vertice della zona. È possibile passare un oggetto RecordSet a questo cmdlet usando l'operatore pipeline o come parametro. Per identificare un set di record in base al nome e al tipo senza usare un oggetto RecordSet , è necessario passare la zona come oggetto DnsZone a questo cmdlet usando l'operatore pipeline o come parametro oppure in alternativa è possibile specificare i parametri ZoneName e ResourceGroupName . È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma. Quando si specifica il set di record usando un oggetto RecordSet, il set di record non viene eliminato se è stato modificato in DNS di Azure dopo il recupero dell'oggetto RecordSet locale. In questo modo viene fornita la protezione per le modifiche simultanee. È possibile eliminare questa operazione usando il parametro Sovrascrivi , che elimina il set di record indipendentemente dalle modifiche simultanee.

Esempio

Esempio 1: Rimuovere un set di record

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

Il primo comando ottiene il set di record specificato e quindi lo archivia nella variabile $RecordSet. Il secondo comando rimuove il set di record in $RecordSet.

Esempio 2: Rimuovere un set di record e eliminare tutte le conferme

$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

Il primo comando ottiene il set di record specificato. Il secondo comando elimina il set di record, anche se è stato modificato nel frattempo. Le richieste di conferma vengono eliminate.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome dell'oggetto RecordSet da rimuovere. Quando si specifica il set di record in base al nome, è necessario specificare la zona DNS usando il parametro Zone o i parametri ZoneName e ResourceGroupName. In alternativa, è possibile specificare il set di record usando un oggetto RecordSet , passato usando il parametro RecordSet .

Tipo:String
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

Quando si specifica il set di record usando un oggetto RecordSet, il set di record non viene eliminato se è stato modificato in DNS di Azure dopo il recupero dell'oggetto RecordSet locale. In questo modo viene fornita la protezione per le modifiche simultanee. Questa operazione può essere eliminata usando il parametro Sovrascrivi , che elimina il set di record indipendentemente dalle modifiche simultanee.

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Passthru

Tipo:SwitchParameter
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Specifica l'oggetto RecordSet da rimuovere. In alternativa, è possibile specificare il set di record usando i parametri Name e Zone oppure usando i parametri Name, ZoneName e ResourceGroupName .

Tipo:DnsRecordSet
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

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

  • Un
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • I record SOA TXT vengono eliminati automaticamente quando la zona viene eliminata. Non è possibile eliminare manualmente i record SOA.
Tipo:RecordType
valori accettati:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifica il gruppo di risorse che contiene la zona DNS che contiene l'oggetto RecordSet da eliminare. Questo parametro è applicabile solo quando il set di record e la zona DNS vengono specificati usando i parametri Name e ZoneName . In alternativa, è possibile specificare il set di record usando il parametro RecordSet o i parametri Name e Zone .

Tipo:String
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
valore predefinito:False
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Specifica la zona DNS che contiene l'oggetto RecordSet da eliminare. Questo parametro è applicabile solo quando si specifica il set di record usando il parametro Name . In alternativa, è possibile specificare il set di record usando il parametro RecordSet o i parametri Name, ZoneName e ResourceGroupName.

Tipo:DnsZone
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

Specifica il nome della zona che contiene l'oggetto RecordSet da eliminare. È inoltre necessario specificare i parametri Name e ResourceGroupName . In alternativa, è possibile specificare il set di record usando il parametro RecordSet o i parametri Name e Zone .

Tipo:String
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

Input

RecordType

String

DnsZone

DnsRecordSet

Output

Boolean

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 Windows PowerShell $ConfirmPreference 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.