Condividi tramite

Remove-AzPrivateDnsRecordSet

  • Riferimento
Modulo:
Az.PrivateDns

Elimina un set di record da una zona DNS privato.

Sintassi

Remove-AzPrivateDnsRecordSet
      -ResourceGroupName <String>
      -ZoneName <String>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -Zone <PSPrivateDnsZone>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -RecordSet <PSPrivateDnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-AzPrivateDnsRecordSet elimina il set di record specificato dalla zona specificata. Non è possibile eliminare i record SOA creati automaticamente al vertice della zona privata. È possibile passare un oggetto RecordSet a questo cmdlet usando l'operatore pipeline o come parametro o come ResourceId. Per identificare un set di record in base al nome e al tipo senza usare un oggetto RecordSet, è necessario passare la zona come oggetto PSPrivateDnsZone a questo cmdlet usando l'operatore della 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 privato 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-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -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-AzPrivateDnsRecordSet -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
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
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

-Name

Nome dei record nel set di record (relativo al nome della zona e senza punto di terminazione).

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

-Overwrite

Non usare il campo ETag del parametro RecordSet per i controlli di concorrenza ottimistica.

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

-PassThru

Usato per passare il risultato (booleano) dell'operazione di eliminazione della zona privata più avanti nella pipeline.

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

-RecordType

Tipo di record DNS privati nel set di record.

Tipo:RecordType
Valori accettati:A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceGroupName

Gruppo di risorse a cui appartiene la zona.

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

-ResourceId

Id risorsa recordset DNS privato.

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Zone

Oggetto PrivateDnsZone che rappresenta la zona in cui creare il set di record.

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

-ZoneName

Zona in cui è presente il set di record (senza un punto di terminazione).

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

Input

Output