Udostępnij przez

Remove-AzDnsZone

Moduł:
Az.Dns Module

Usuwa strefę DNS z grupy zasobów.

Składnia

Fields 

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

Object 

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

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

-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 .

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

Fields
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

Object
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

-PassThru

passthru

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

-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 .

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

Fields
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-WhatIf

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

-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 .

Właściwości parametrów

Typ:DnsZone
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

Object
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

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

String

DnsZone

Wyjść

Boolean

Notatki

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.