Remove-AzDnsRecordSet
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 |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | False |
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
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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PassThru
passthru
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
Input
Output
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.