Condividi tramite

Set-AzDnsRecordSet

  • Riferimento
Modulo:
Az.Dns

Aggiorna un set di record DNS.

Sintassi

Set-AzDnsRecordSet
   -RecordSet <DnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzDnsRecordSet aggiorna un set di record nel servizio DNS di Azure da un oggetto RecordSet locale. È possibile passare un oggetto RecordSet come parametro o usando l'operatore pipeline. È possibile usare il parametro Confirm e $ConfirmPreference variabile di Windows PowerShell per controllare se il cmdlet richiede la conferma. Il set di record non viene aggiornato 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 questo comportamento usando il parametro Sovrascrivi , che aggiorna il set di record indipendentemente dalle modifiche simultanee.

Esempio

Esempio 1: Aggiornare un set di record

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet

Il primo comando usa il cmdlet Get-AzDnsRecordSet per ottenere il set di record specificato e quindi lo archivia nella variabile $RecordSet. I secondi e i terzi comandi sono operazioni off-line per aggiungere due record A al set di record. Il comando finale usa il cmdlet Set-AzDnsRecordSet per eseguire il commit dell'aggiornamento.

Esempio 2: Aggiornare un record SOA

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet

Il primo comando usa il cmdlet Get-AzDnsRecordset per ottenere il set di record specificato e quindi lo archivia nella variabile $RecordSet. Il secondo comando aggiorna il record SOA specificato in $RecordSet. Il comando finale usa il cmdlet Set-AzDnsRecordSet per propagare l'aggiornamento in $RecordSet.

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

-Overwrite

Indica di aggiornare il set di record indipendentemente dalle modifiche simultanee. Il set di record non verrà aggiornato 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. Per eliminare questo comportamento, è possibile usare il parametro Overwrite , che comporta l'aggiornamento del 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

-RecordSet

Specifica l'oggetto RecordSet da aggiornare.

Tipo:DnsRecordSet
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. Mostra cosa accadrebbe se il cmdlet viene eseguito. 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

Input

DnsRecordSet

Output

DnsRecordSet

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.