Udostępnij przez

Remove-AzDnsRecordSet

Moduł:
Az.Dns Module

Usuwa zestaw rekordów.

Składnia

Fields 

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

Mixed 

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

Object 

Remove-AzDnsRecordSet
    -RecordSet <DnsRecordSet>
    [-Overwrite]
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzDnsRecordSet usuwa określony zestaw rekordów z określonej strefy. Nie można usunąć rekordów SOA lub serwera nazw (NS), które są automatycznie tworzone w wierzchołku strefy. Obiekt RecordSet można przekazać do tego polecenia cmdlet przy użyciu operatora potoku lub jako parametru. Aby zidentyfikować zestaw rekordów według nazwy i typu bez użycia obiektu RecordSet , należy przekazać strefę jako obiekt DnsZone 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 zmiennej programu Windows 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 usłudze Azure 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-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -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-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -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-AzDnsRecordSet -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ść: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ę zestawu rekordów do usunięcia. Podczas określania zestawu rekordów według nazwy należy określić strefę DNS przy użyciu parametru Zone lub parametru ZoneName i ResourceGroupName . Alternatywnie zestaw rekordów można określić przy użyciu obiektu RecordSet przekazanego przy użyciu parametru RecordSet .

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

Podczas określania zestawu rekordów przy użyciu obiektu RecordSet zestaw rekordów nie jest usuwany, jeśli został zmieniony w usłudze Azure 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.

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

passthru

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

Określa obiekt RecordSet do usunięcia. Alternatywnie zestaw rekordów można określić przy użyciu parametrów Nazwa i Strefa lub parametrów Name, ZoneName i ResourceGroupName .

Właściwości parametru

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

Określa typ rekordu DNS. Prawidłowe wartości to:

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • widok zasobów programu do cieniowania
  • Rekordy SOA TXT są usuwane automatycznie po usunięciu strefy. Nie można ręcznie usunąć rekordów SOA.

Właściwości parametru

Typ:RecordType
Domyślna wartość:None
Dopuszczalne wartości:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
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:True
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:True
Wartość z pozostałych argumentów:False

-ResourceGroupName

Określa grupę zasobów zawierającą strefę DNS zawierającą zestaw rekordów do usunięcia. Ten parametr ma zastosowanie tylko wtedy, gdy zestaw rekordów i strefa DNS są określone przy użyciu parametrów Name i ZoneName . Alternatywnie można określić zestaw rekordów przy użyciu parametru RecordSet lub parametrów Nazwa i 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: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

-Zone

Określa strefę DNS zawierającą zestaw rekordów do usunięcia. Ten parametr ma zastosowanie tylko podczas określania zestawu rekordów przy użyciu parametru Name . Alternatywnie można określić zestaw rekordów przy użyciu parametru RecordSet lub parametrów Name, ZoneName i ResourceGroupName .

Właściwości parametru

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

Określa nazwę strefy zawierającej zestaw rekordów do usunięcia. Należy również określić parametry Name i ResourceGroupName . Alternatywnie zestaw rekordów można określić przy użyciu parametru RecordSet lub parametrów Nazwa i 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:True
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

RecordType

String

DnsZone

DnsRecordSet

Dane wyjściowe

Boolean

Uwagi

Możesz użyć parametru Confirm , aby określić, czy to polecenie cmdlet wyświetli monit o potwierdzenie. Domyślnie polecenie cmdlet wyświetla monit o potwierdzenie, jeśli zmienna programu Windows PowerShell $ConfirmPreference ma wartość Średnia lub niższa. 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.