Udostępnij za pośrednictwem

Remove-AzDnsRecordSet

  • Odwołanie
Moduł:
Az.Dns

Usuwa zestaw rekordów.

Składnia

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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

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

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters: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.

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

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

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

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • Rekordy SOA TXT są usuwane automatycznie po usunięciu strefy. Nie można ręcznie usunąć rekordów SOA.
Typ:RecordType
akceptowane wartości:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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.

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

Typ:DnsZone
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters: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.

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

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.