다음을 통해 공유

Remove-AzDnsRecordSet

  • 참조
모듈:
Az.Dns

레코드 집합을 삭제합니다.

Syntax

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

Description

Remove-AzDnsRecordSet cmdlet은 지정된 영역에서 지정된 레코드 집합을 삭제합니다. 영역 루트에서 자동으로 생성되는 SOA 또는 NS(이름 서버) 레코드는 삭제할 수 없습니다. 파이프라인 연산자를 사용하거나 매개 변수로 사용하여 RecordSet 개체를 이 cmdlet에 전달할 수 있습니다. RecordSet 개체를 사용하지 않고 이름 및 형식으로 설정된 레코드를 식별하려면 파이프라인 연산자 또는 매개 변수를 사용하여 이 cmdlet에 DnsZone 개체로 영역을 전달하거나 ZoneName 및 ResourceGroupName 매개 변수를 지정할 수 있습니다. Confirm 매개 변수 및 $ConfirmPreference Windows PowerShell 변수를 사용하여 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다. RecordSet 개체를 사용하여 레코드 집합을 지정할 때 로컬 RecordSet 개체를 검색한 이후 Azure DNS에서 변경된 레코드 집합은 삭제되지 않습니다. 이렇게 하면 동시 변경 내용에 대한 보호가 제공됩니다. 동시 변경 내용에 관계없이 레코드 집합을 삭제하는 덮어쓰 기 매개 변수를 사용하여 이를 표시하지 않을 수 있습니다.

예제

예제 1: 레코드 집합 제거

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

첫 번째 명령은 지정된 레코드 집합을 가져오고 $RecordSet 변수에 저장합니다. 두 번째 명령은 $RecordSet 레코드 집합을 제거합니다.

예제 2: 레코드 집합 제거 및 모든 확인 표시 안 함

$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

첫 번째 명령은 지정된 레코드 집합을 가져옵니다. 두 번째 명령은 그 동안 변경된 경우에도 레코드 집합을 삭제합니다. 확인 프롬프트가 표시되지 않습니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

제거할 RecordSet의 이름을 지정합니다. 이름으로 레코드 집합을 지정할 때는 영역 매개 변수 또는 ZoneName 및 ResourceGroupName 매개 변수를 사용하여 DNS 영역을 지정해야 합니다. 또는 RecordSet 매개 변수를 사용하여 전달되는 RecordSet 개체를 사용하여 레코드 집합을 지정할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

RecordSet 개체를 사용하여 레코드 집합을 지정할 때 로컬 RecordSet 개체를 검색한 이후 Azure DNS에서 변경된 레코드 집합은 삭제되지 않습니다. 이렇게 하면 동시 변경 내용에 대한 보호가 제공됩니다. 동시 변경 내용에 관계없이 레코드 집합을 삭제하는 덮어쓰 기 매개 변수를 사용하여 이를 표시하지 않을 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordSet

제거할 RecordSet 개체를 지정합니다. 또는 이름 및 영역 매개 변수를 사용하거나 Name, ZoneName 및 ResourceGroupName 매개 변수를 사용하여 레코드 집합을 지정할 수 있습니다.

Type:DnsRecordSet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

DNS 레코드의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA 레코드는 영역이 삭제될 때 자동으로 삭제됩니다. SOA 레코드는 수동으로 삭제할 수 없습니다.
Type:RecordType
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

삭제할 RecordSet을 포함하는 DNS 영역을 포함하는 리소스 그룹을 지정합니다. 이 매개 변수는 Name 및 ZoneName 매개 변수를 사용하여 레코드 집합 및 DNS 영역을 지정한 경우에만 적용됩니다. 또는 RecordSet 매개 변수 또는 Name 및 Zone 매개 변수를 사용하여 레코드 집합을 지정할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

삭제할 RecordSet을 포함하는 DNS 영역을 지정합니다. 이 매개 변수는 Name 매개 변수를 사용하여 레코드 집합을 지정하는 경우에만 적용됩니다. 또는 RecordSet 매개 변수 또는 Name, ZoneName 및 ResourceGroupName 매개 변수를 사용하여 레코드 집합을 지정할 수 있습니다.

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

삭제할 RecordSet을 포함하는 영역의 이름을 지정합니다. Name 및 ResourceGroupName 매개 변수도 지정해야 합니다. 또는 RecordSet 매개 변수 또는 Name 및 Zone 매개 변수를 사용하여 레코드 집합을 지정할 수 있습니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

입력

RecordType

String

DnsZone

DnsRecordSet

출력

Boolean

참고

Confirm 매개 변수를 사용하여 이 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다. 기본적으로 cmdlet은 $ConfirmPreference Windows PowerShell 변수의 값이 중간 이하인지 확인하라는 메시지를 표시합니다. Confirm 또는 Confirm:$True 지정하는 경우 이 cmdlet은 실행하기 전에 확인 메시지를 표시합니다. Confirm:$False 지정하면 cmdlet에서 확인 메시지를 표시하지 않습니다.