Remove-AzPrivateDnsRecordConfig

Odwołanie

Moduł:: Az.PrivateDns

Usuwa prywatny rekord DNS z obiektu lokalnego zestawu rekordów.

Składnia

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Ipv4Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Ipv6Address <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Exchange <String>
      -Preference <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Ptrdname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Value <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Priority <UInt16>
      -Target <String>
      -Port <UInt16>
      -Weight <UInt16>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Remove-AzPrivateDnsRecordConfig
      -RecordSet <PSPrivateDnsRecordSet>
      -Cname <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-AzPrivateDnsRecordConfig usuwa rekord systemu nazw domen prywatnych (DNS) z zestawu rekordów. Obiekt RecordSet jest obiektem offline i zmiany w nim nie zmieniają prywatnych odpowiedzi DNS dopiero po uruchomieniu polecenia cmdlet Set-AzPrivateDnsRecordSet, aby utrwały zmianę w prywatnej usłudze DNS platformy Microsoft Azure. 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 po utworzeniu prywatnej strefy DNS i automatycznie usuwane po usunięciu prywatnej 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-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/A/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : A
Records           : {}
Metadata          :
IsAutoRegistered  :

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

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

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

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/AAAA/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : AAAA
Records           : {}
Metadata          :
IsAutoRegistered  :

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

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

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

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/CNAME/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : CNAME
Records           : {}
Metadata          :
IsAutoRegistered  :

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-AzPrivateDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzPrivateDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzPrivateDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/MX/www
Name              : www
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : MX
Records           : {}
Metadata          :
IsAutoRegistered  :

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

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

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

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name              : 4
ZoneName          : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : PTR
Records           : {}
Metadata          :
IsAutoRegistered  :

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

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

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

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name              : _sip._tcp
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : SRV
Records           : {}
Metadata          :
IsAutoRegistered  :

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

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

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

# The above sequence can also be piped:

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

Id                : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
                    oft.Network/privateDnsZones/myzone.com/TXT/text
Name              : text
ZoneName          : myzone.com
ResourceGroupName : MyResourceGroup
Ttl               : 3600
Etag              : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType        : TXT
Records           : {}
Metadata          :
IsAutoRegistered  :

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

Parametry

-Cname

Nazwa kanoniczna rekordu CNAME do usunięcia. Nie może być względem nazwy strefy. Nie może mieć kropki zakończenia

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
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

-Exchange

Host wymiany poczty rekordu MX do usunięcia. Nie może być względem nazwy strefy. Nie może mieć kropki zakończenia

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

-Ipv4Address

Adres IPv4 rekordu A do usunięcia.

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

-Ipv6Address

Adres IPv6 rekordu AAAA do usunięcia.

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

-Port

Numer portu rekordu SRV do usunięcia.

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

-Preference

Wartość preferencji rekordu MX do usunięcia.

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

-Priority

Wartość priorytetu rekordu SRV do usunięcia.

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

-Ptrdname

Docelowy host rekordu PTR do usunięcia. Nie może być względem nazwy strefy. Nie może mieć kropki zakończenia

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

-RecordSet

Zestaw rekordów, z którego ma być usuwany rekord.

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

-Target

Docelowy host rekordu SRV do usunięcia. Nie może być względem nazwy strefy. Nie może mieć kropki zakończenia

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

-Value

Wartość tekstowa rekordu TXT do usunięcia.

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

-Weight

Wartość wagi rekordu SRV do usunięcia.

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

Dane wejściowe

PSPrivateDnsRecordSet

Dane wyjściowe