Udostępnij za pośrednictwem

Remove-AzPrivateDnsZone

  • Odwołanie
Moduł:
Az.PrivateDns

Usuwa prywatną strefę DNS z grupy zasobów.

Składnia

Remove-AzPrivateDnsZone
      -ResourceGroupName <String>
      -Name <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -PrivateZone <PSPrivateDnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPrivateDnsZone
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzPrivateDnsZone trwale usuwa strefę prywatnego systemu nazw domen (DNS) z określonej grupy zasobów. Wszystkie zestawy rekordów zawarte w strefie są również usuwane. Można przekazać obiekt PrivateDnsZone przy użyciu parametru PrivateZone lub operatora potoku lub użyć operatora potoku, a także określić parametry nazwa 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 strefy przy użyciu obiektu PrivateDnsZone (przekazywanego za pośrednictwem potoku lub strefy parametru), strefa nie jest usuwana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania obiektu PrivateDnsZone (tylko operacje bezpośrednio na podstawie liczby zasobów strefy DNS jako zmiany, operacje na zestawach rekordów w strefie nie są pobierane). Zapewnia to ochronę zmian strefy współbieżnych. Można to pominąć przy użyciu parametru Zastąp, który usuwa strefę niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Usuwanie strefy prywatnej

Remove-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

To polecenie usuwa strefę o nazwie myzone.com z grupy zasobów o nazwie MyResourceGroup.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
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

Określa nazwę prywatnej strefy DNS, którą usuwa to polecenie cmdlet. Należy również określić parametr ResourceGroupName. Alternatywnie można określić strefę DNS przy użyciu parametru strefy.

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

-Overwrite

Podczas określania strefy przy użyciu obiektu PrivateDnsZone (przekazywanego za pośrednictwem potoku lub strefy parametru), strefa nie jest usuwana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania obiektu PrivateDnsZone (tylko operacje bezpośrednio na podstawie liczby zasobów strefy DNS jako zmiany, operacje na zestawach rekordów w strefie nie są pobierane). Zapewnia to ochronę zmian strefy współbieżnych. Można to pominąć przy użyciu parametru Zastąp, który usuwa strefę niezależnie od współbieżnych zmian.

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

-PrivateZone

Obiekt strefy prywatnej do usunięcia.

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

-ResourceGroupName

Określa nazwę grupy zasobów, która zawiera strefę do usunięcia. Należy również określić parametr ZoneName. Alternatywnie można określić strefę DNS przy użyciu obiektu PrivateDnsZone przekazywanego za pośrednictwem potoku lub parametru Zone.

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

-ResourceId

Identyfikator zasobu prywatnej strefy 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ść:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Dane wyjściowe