Remove-AzPrivateDnsRecordSet

Odwołanie

Moduł:: Az.PrivateDns

Usuwa zestaw rekordów z prywatnej strefy DNS.

Składnia

Remove-AzPrivateDnsRecordSet
      -ResourceGroupName <String>
      -ZoneName <String>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordSet
      -Zone <PSPrivateDnsZone>
      -Name <String>
      -RecordType <RecordType>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

Remove-AzPrivateDnsRecordSet
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzPrivateDnsRecordSet usuwa określony zestaw rekordów z określonej strefy. Nie można usunąć rekordów SOA, które są automatycznie tworzone w wierzchołku strefy prywatnej. Obiekt RecordSet można przekazać do tego polecenia cmdlet przy użyciu operatora potoku lub jako parametru lub jako identyfikatora zasobu. Aby zidentyfikować zestaw rekordów według nazwy i typu bez użycia obiektu RecordSet, należy przekazać strefę jako obiekt PSPrivateDnsZone do tego polecenia cmdlet przy użyciu operatora potoku lub jako parametru lub alternatywnie można określić parametry ZoneName i ResourceGroupName. Możesz użyć parametru Confirm i $ConfirmPreference zmiennej programu Windows PowerShell, aby kontrolować, czy polecenie cmdlet wyświetli monit o potwierdzenie. Podczas określania zestawu rekordów przy użyciu obiektu RecordSet zestaw rekordów nie jest usuwany, jeśli został zmieniony w usłudze Azure Private DNS od czasu pobrania lokalnego obiektu RecordSet. Zapewnia to ochronę współbieżnych zmian. Można to pominąć przy użyciu parametru Overwrite, który usuwa zestaw rekordów niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Usuwanie zestawu rekordów

$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordSet -RecordSet $RecordSet

Pierwsze polecenie pobiera określony zestaw rekordów, a następnie zapisuje go w zmiennej $RecordSet. Drugie polecenie usuwa zestaw rekordów w $RecordSet.

Przykład 2. Usuwanie zestawu rekordów i pomijanie wszystkich potwierdzeń

$RecordSet = Get-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzPrivateDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzPrivateDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$False

Pierwsze polecenie pobiera określony zestaw rekordów. Drugie polecenie usuwa zestaw rekordów, nawet jeśli zmienił się w międzyczasie. Monity o potwierdzenie są pomijane.

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

-Name

Nazwa rekordów w zestawie rekordów (względem nazwy strefy i bez kropki zakończenia).

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
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

-PassThru

Służy do przekazywania wyniku (logicznego) operacji usuwania strefy prywatnej dalej potoku.

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

-RecordType

Typ prywatnych rekordów DNS w zestawie rekordów.

Typ:	RecordType
Dopuszczalne wartości:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupName

Grupa zasobów, do której należy strefa.

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

-ResourceId

Prywatny identyfikator resourceID zestawu rekordów DNS.

Typ:	String
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

-Zone

Obiekt PrivateDnsZone reprezentujący strefę, w której ma zostać utworzony zestaw rekordów.

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

-ZoneName

Strefa, w której istnieje zestaw rekordów (bez kropki zakończenia).

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

Dane wejściowe

PSPrivateDnsZone

PSPrivateDnsRecordSet

String

Dane wyjściowe

Boolean

Udostępnij za pośrednictwem