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.