다음을 통해 공유

Remove-AzDnsRecordSet

  • 참조
모듈:
Az.Dns

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

구문

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을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

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

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Overwrite

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

passthru

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RecordSet

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

형식:DnsRecordSet
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • TXT SOA 레코드는 영역이 삭제될 때 자동으로 삭제됩니다. SOA 레코드는 수동으로 삭제할 수 없습니다.
형식:RecordType
허용되는 값:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Zone

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

형식:DnsZone
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ZoneName

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

출력

참고

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