Udostępnij za pośrednictwem

Remove-AzDnsZone

  • Odwołanie
Moduł:
Az.Dns

Usuwa strefę DNS z grupy zasobów.

Składnia

Remove-AzDnsZone
      -Name <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsZone
      -Zone <DnsZone>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzDnsZone trwale usuwa strefę systemu nazw domen (DNS) z określonej grupy zasobów. Wszystkie zestawy rekordów zawarte w strefie są również usuwane. Obiekt DnsZone można przekazać przy użyciu parametru Name lub operatora potoku. 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 strefy przy użyciu obiektu DnsZone (przekazywanego za pośrednictwem potoku lub parametru strefy ) strefa nie jest usuwana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu DnsZone (tylko operacje bezpośrednio w strefie DNS zasób licznika zasobów jako zmiany, operacje na zestawach rekordów w strefie nie). Zapewnia to ochronę zmian strefy współbieżnych. Można to pominąć przy użyciu parametru Overwrite , który usuwa strefę niezależnie od współbieżnych zmian.

Przykłady

Przykład 1. Usuwanie strefy

Remove-AzDnsZone -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
Aliases:cf
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę 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 Zone .

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Overwrite

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

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

passthru

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters: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 DnsZone przekazanego za pośrednictwem potoku lub parametru Zone .

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliases:wi
Position:Named
wartość domyślna:False
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Określa strefę DNS do usunięcia. Przekazany obiekt DnsZone można również przekazać za pośrednictwem potoku. Alternatywnie można określić strefę DNS do usunięcia przy użyciu parametrów ZoneName i ResourceGroupName .

Typ:DnsZone
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

DnsZone

Dane wyjściowe

Boolean

Uwagi

Ze względu na potencjalnie duży wpływ usunięcia strefy DNS domyślnie to polecenie cmdlet monituje o potwierdzenie, jeśli zmienna programu Windows PowerShell $ConfirmPreference ma dowolną wartość inną niż Brak. 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.