Set-AzDnsRecordSet

  • Odwołanie
Moduł:
Az.Dns

Aktualizacje zestawu rekordów DNS.

Składnia

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

Opis

Polecenie cmdlet Set-AzDnsRecordSet aktualizuje zestaw rekordów w usłudze Azure DNS z lokalnego obiektu RecordSet . Obiekt RecordSet można przekazać jako parametr lub za pomocą operatora potoku. Możesz użyć parametru Confirm i $ConfirmPreference zmiennej programu Windows PowerShell, aby kontrolować, czy polecenie cmdlet wyświetli monit o potwierdzenie. Zestaw rekordów nie jest aktualizowany, jeśli został zmieniony w usłudze Azure DNS od czasu pobrania lokalnego obiektu RecordSet . Zapewnia to ochronę współbieżnych zmian. To zachowanie można pominąć przy użyciu parametru Overwrite , który aktualizuje zestaw rekordów niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Aktualizowanie zestawu rekordów

$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

Pierwsze polecenie używa polecenia cmdlet Get-AzDnsRecordSet w celu pobrania określonego zestawu rekordów, a następnie zapisuje je w zmiennej $RecordSet. Drugie i trzecie polecenia to operacje poza wierszem, aby dodać dwa rekordy A do zestawu rekordów. Ostatnie polecenie używa polecenia cmdlet Set-AzDnsRecordSet w celu zatwierdzenia aktualizacji.

Przykład 2. Aktualizowanie rekordu 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

Pierwsze polecenie używa polecenia cmdlet Get-AzDnsRecordset w celu pobrania określonego zestawu rekordów, a następnie zapisuje je w zmiennej $RecordSet. Drugie polecenie aktualizuje określony rekord SOA w $RecordSet. Ostatnie polecenie używa polecenia cmdlet Set-AzDnsRecordSet do propagowania aktualizacji w $RecordSet.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

Wskazuje, aby zaktualizować zestaw rekordów niezależnie od współbieżnych zmian. Zestaw rekordów nie zostanie zaktualizowany, jeśli został zmieniony w usłudze Azure DNS od czasu pobrania lokalnego obiektu RecordSet . Zapewnia to ochronę współbieżnych zmian. Aby pominąć to zachowanie, można użyć parametru Overwrite , co powoduje zaktualizowanie zestawu rekordów niezależnie od współbieżnych zmian.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

Określa zestaw rekordów do aktualizacji.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane. Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

DnsRecordSet

Dane wyjściowe

DnsRecordSet

Uwagi

Możesz użyć parametru Confirm, aby określić, czy to polecenie cmdlet wyświetli monit o potwierdzenie. Domyślnie polecenie cmdlet wyświetla monit o potwierdzenie, jeśli zmienna programu Windows PowerShell $ConfirmPreference ma wartość Średnia lub niższa. Jeśli określisz opcję Potwierdź lub Potwierdź:$True, to polecenie cmdlet wyświetli monit o potwierdzenie przed jego uruchomieniem. Jeśli określisz wartość Confirm:$False, polecenie cmdlet nie wyświetli monitu o potwierdzenie.