Remove-AzPrivateDnsRecordSet

Moduł:

Az.PrivateDns Module

Usuwa zestaw rekordów ze strefy Prywatna strefa DNS.

Składnia

Fields (domyślnie)

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

Mixed

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

Object

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

ResourceId

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 Windows zmiennej programu 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 Azure Prywatna strefa 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

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
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 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

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

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

Mixed

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

Nie używaj pola ETag parametru RecordSet do sprawdzania optymistycznej współbieżności.

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

-RecordSet

Zestaw rekordów, w którym ma zostać dodany rekord.

Właściwości parametru

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

-RecordType

Typ rekordów Prywatna strefa DNS w zestawie rekordów.

Właściwości parametru

Typ:	RecordType
Domyślna wartość:	None
Dopuszczalne wartości:	A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT
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

Mixed

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

-ResourceGroupName

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

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

Prywatna strefa DNS identyfikator resourceID zestawu rekordów.

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ść:	None
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

-Zone

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

Właściwości parametru

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

Zestawy parametrów

Mixed

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

-ZoneName

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

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

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

PSPrivateDnsRecordSet

String

Dane wyjściowe

Boolean