Udostępnij za pośrednictwem

Set-AzPrivateDnsRecordSet

  • Odwołanie
Moduł:
Az.PrivateDns

Aktualizuje/ustawia zestaw rekordów w prywatnej strefie DNS.

Składnia

Set-AzPrivateDnsRecordSet
   -RecordSet <PSPrivateDnsRecordSet>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzPrivateDnsRecordSet aktualizuje zestaw rekordów w prywatnej usłudze DNS platformy Azure 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 prywatnym systemie DNS platformy Azure 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-AzPrivateDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# These cmdlets can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
                    rk/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {1.2.3.4, 172.16.0.0, 172.31.255.255}
Metadata          :
IsAutoRegistered  :

Pierwsze polecenie używa polecenia cmdlet Get-AzPrivateDnsRecordSet 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-AzPrivateDnsRecordSet do zatwierdzenia aktualizacji.

Przykład 2. Aktualizowanie rekordu SOA

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SOA/@
Name              : @
ZoneName          : myzone.com
ResourceGroupName : Myresourcegroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SOA
Records           : {[internal.cloudapp.net,admin.myzone.com,3600,300,2419200,300]}
Metadata          :
IsAutoRegistered  :

Pierwsze polecenie używa polecenia cmdlet Get-AzPrivateDnsRecordSet do 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-AzPrivateDnsRecordSet do propagowania aktualizacji w $RecordSet.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Overwrite

Nie używaj pola ETag parametru RecordSet do sprawdzania optymistycznej współbieżności.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RecordSet

Zestaw rekordów, w którym ma zostać dodany rekord.

Typ:PSPrivateDnsRecordSet
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe