Udostępnij przez

Remove-AzPrivateDnsZone

Moduł:
Az.PrivateDns Module

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

Składnia

Fields (domyślnie) 

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

Object 

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

ResourceId 

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. Obiekt PrivateDnsZone można przekazać przy użyciu parametru PrivateZone lub operatora potoku. Alternatywnie można określić parametry Name 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 parametru strefy ) strefa nie jest usuwana, jeśli została zmieniona w usłudze Azure DNS od czasu pobrania lokalnego obiektu PrivateDnsZone (nie są pobierane tylko operacje bezpośrednio na podstawie liczby zasobów strefy DNS 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 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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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 Zone .

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Fields
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Overwrite

Podczas określania strefy przy użyciu obiektu PrivateDnsZone (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 PrivateDnsZone (nie są pobierane tylko operacje bezpośrednio na podstawie liczby zasobów strefy DNS 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 parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Object
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PassThru

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateZone

Obiekt strefy prywatnej do usunięcia.

Właściwości parametru

Typ:PSPrivateDnsZone
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Object
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z 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 PrivateDnsZone przekazanego za pośrednictwem potoku lub parametru Zone .

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Fields
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceId

Identyfikator zasobu prywatnej strefy DNS.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ResourceId
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z 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.

Dane wejściowe

PSPrivateDnsZone

String

Dane wyjściowe

Boolean