Udostępnij za pośrednictwem


Remove-AzDnsRecordConfig

Usuwa rekord DNS z lokalnego obiektu zestawu rekordów.

Składnia

Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Nsdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -CaaFlags <Byte>
      -CaaTag <String>
      -CaaValue <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -KeyTag <Int32>
      -Algorithm <Int32>
      -DigestType <Int32>
      -Digest <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]
Remove-AzDnsRecordConfig
      -RecordSet <DnsRecordSet>
      -Usage <Int32>
      -Selector <Int32>
      -MatchingType <Int32>
      -CertificateAssociationData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzDnsRecordConfig usuwa rekord systemu nazw domen (DNS) z zestawu rekordów. Obiekt RecordSet jest obiektem offline i zmiany w nim nie zmieniają odpowiedzi DNS dopiero po uruchomieniu polecenia cmdlet Set-AzDnsRecordSet, aby utrwały zmianę usługi Microsoft Azure DNS. Aby usunąć rekord, wszystkie pola dla tego typu rekordu muszą być dokładnie zgodne. Nie można dodawać ani usuwać rekordów SOA. Rekordy SOA są tworzone automatycznie podczas tworzenia strefy DNS i automatycznie usuwane po usunięciu strefy DNS. Obiekt RecordSet można przekazać do tego polecenia cmdlet jako parametr lub za pomocą operatora potoku.

Przykłady

Przykład 1. Usuwanie rekordu A z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

W tym przykładzie rekord A jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik będzie pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 2. Usuwanie rekordu AAAA z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

W tym przykładzie rekord AAAA jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik będzie pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 3. Usuwanie rekordu CNAME z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

W tym przykładzie rekord CNAME jest usuwany z istniejącego zestawu rekordów. Ponieważ zestaw rekordów CNAME może zawierać co najwyżej jeden rekord, wynik jest pustym zestawem rekordów.

Przykład 4. Usuwanie rekordu MX z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

W tym przykładzie rekord MX jest usuwany z istniejącego zestawu rekordów. Nazwa rekordu "@" wskazuje zestaw rekordów w wierzchołkach strefy. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 5. Usuwanie rekordu NS z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "abc" -RecordType NS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Nsdname "ns1.myzone.com" | Set-AzDnsRecordSet

W tym przykładzie rekord NS jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 6. Usuwanie rekordu PTR z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName 3.2.1.in-addr.arpa
Remove-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -ZoneName "3.2.1.in-addr.arpa" | Remove-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

W tym przykładzie rekord PTR jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 7. Usuwanie rekordu SRV z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

W tym przykładzie rekord SRV jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 8. Usuwanie rekordu TXT z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Value "This is a TXT Record"  | Set-AzDnsRecordSet

W tym przykładzie rekord TXT jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 9. Usuwanie rekordu DS z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "www" -RecordType DS -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

W tym przykładzie rekord DS jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Przykład 10: Usuwanie rekordu TLSA z zestawu rekordów

$RecordSet = Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" | Remove-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"  | Set-AzDnsRecordSet

W tym przykładzie rekord TLSA jest usuwany z istniejącego zestawu rekordów. Jeśli jest to jedyny rekord w zestawie rekordów, wynik jest pustym zestawem rekordów. Aby całkowicie usunąć zestaw rekordów, zobacz Remove-AzDnsRecordSet.

Parametry

-Algorithm

Pole algorytmu rekordu DS do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CaaFlags

Flagi rekordu CAA do dodania. Musi być liczbą z zakresu od 0 do 255.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CaaTag

Pole tagu rekordu CAA do dodania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CaaValue

Pole wartości rekordu CAA do dodania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CertificateAssociationData

Pole danych skojarzenia certyfikatu rekordu TLSA do usunięcia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Cname

Określa nazwę domeny rekordu nazwy kanonicznej (CNAME).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Digest

Pole skrótu rekordu DS do usunięcia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DigestType

Pole typu skrótu rekordu DS do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Exchange

Określa nazwę serwera wymiany poczty dla rekordu wymiany poczty (MX).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Ipv4Address

Określa adres IPv4 dla rekordu A.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Ipv6Address

Określa adres IPv6 dla rekordu AAAA.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-KeyTag

Pole tagu klucza rekordu DS do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MatchingType

Pasujące pole typu rekordu TLSA do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Nsdname

Określa serwer nazw rekordu serwera nazw (NS).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Port

Określa port rekordu usługi (SRV).

Typ:UInt16
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Preference

Określa preferencję rekordu MX.

Typ:UInt16
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Priority

Określa priorytet rekordu SRV.

Typ:UInt16
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Ptrdname

Określa docelową nazwę domeny rekordu wskaźnika (PTR).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RecordSet

Określa obiekt RecordSet zawierający rekord do usunięcia.

Typ:DnsRecordSet
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Selector

Pole selektora rekordu TLSA do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Target

Określa element docelowy rekordu SRV.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Usage

Pole użycia rekordu TLSA do usunięcia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Value

Określa wartość rekordu TXT.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Weight

Określa wagę rekordu SRV.

Typ:UInt16
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

DnsRecordSet

String

UInt16

Byte

Dane wyjściowe

DnsRecordSet