Udostępnij przez


Set-AzDnsRecordSet

Aktualizuje zestaw rekordów DNS.

Składnia

Default (Domyślne)

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 do 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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-RecordSet

Określa zestaw rekordów do aktualizacji.

Właściwości parametrów

Typ:DnsRecordSet
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane. Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

DnsRecordSet

Wyjść

DnsRecordSet

Notatki

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.