다음을 통해 공유


New-AzDnsZone

새 DNS 영역을 만듭니다.

구문

New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneId <String>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZone <DnsZone>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzDnsZone cmdlet은 지정된 리소스 그룹에 새 DNS(도메인 이름 시스템) 영역을 만듭니다. Name 매개 변수에 대해 고유한 DNS 영역 이름을 지정해야 합니다. 그렇지 않으면 cmdlet이 오류를 반환합니다. 영역을 만든 후 New-AzDnsRecordSet cmdlet을 사용하여 영역에 레코드 집합을 만듭니다. Confirm 매개 변수 및 $ConfirmPreference Windows PowerShell 변수를 사용하여 cmdlet에서 확인을 요청하는지 여부를 제어할 수 있습니다.

예제

예제 1: DNS 영역 만들기

$Zone = New-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

이 명령은 지정된 리소스 그룹에 myzone.com 명명된 새 DNS 영역을 만든 다음 $Zone 변수에 저장합니다.

예제 2: 가상 네트워크 ID를 지정하여 프라이빗 DNS 영역 만들기

$ResVirtualNetworkId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testresgroup/providers/Microsoft.Network/virtualNetworks/resvnet"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetworkId @($ResVirtualNetworkId)

이 명령은 연결된 확인 가상 네트워크(ID 지정)를 사용하여 지정된 리소스 그룹에 myprivatezone.com 명명된 새 프라이빗 DNS 영역을 만든 다음 $Zone 변수에 저장합니다.

예제 3: 가상 네트워크 개체를 지정하여 프라이빗 DNS 영역 만들기

$ResVirtualNetwork = Get-AzVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

이 명령은 연결된 확인 가상 네트워크($ResVirtualNetwork 변수로 참조)를 사용하여 지정된 리소스 그룹에 myprivatezone.com 명명된 새 프라이빗 DNS 영역을 만든 다음 $Zone 변수에 저장합니다.

예제 4: 부모 영역 이름을 지정하여 위임을 사용하여 DNS 영역 만들기

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneName "zone.com"

이 명령은 지정된 리소스 그룹에 mychild.zone.com 명명된 새 자식 DNS 영역을 만들고 $Zone 변수에 저장합니다. 또한 자식 영역과 동일한 구독 및 리소스 그룹에 있는 zone.com 명명된 부모 DNS 영역에 위임을 추가합니다.

예제 5: 부모 영역 ID를 지정하여 위임을 사용하여 DNS 영역 만들기

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneId "/subscriptions/**67e2/resourceGroups/other-rg/providers/Microsoft.Network/dnszones/zone.com"

이 명령은 지정된 리소스 그룹에 mychild.zone.com 명명된 새 자식 DNS 영역을 만들고 $Zone 변수에 저장합니다. 또한 리소스 그룹의 zone.com 명명된 부모 DNS 영역에 위임을 추가합니다. 다른 rg 제공 구독은 만든 자식 영역의 위임과 동일합니다.

예제 6: 부모 영역 개체를 지정하여 위임을 사용하여 DNS 영역 만들기

$PZone = New-AzDnsZone -Name "zone.com" -ResourceGroupName "MyResourceGroup" 
$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZone @($PZone)

이 명령은 지정된 리소스 그룹에 mychild.zone.com 명명된 새 자식 DNS 영역을 만들고 $Zone 변수에 저장합니다. 또한 ParentZone 개체에 전달된 대로 zone.com 이라는 부모 DNS 영역에 위임을 추가합니다.

매개 변수

-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

만들 DNS 영역의 이름을 지정합니다.

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

-ParentZone

위임을 추가할 부모 영역의 전체 이름입니다(종료 점 없음).

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

-ParentZoneId

위임을 추가할 부모 영역의 리소스 ID입니다(종료 점 없음).

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

-ParentZoneName

위임을 추가할 부모 영역의 전체 이름입니다(종료 점 없음).

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

-RegistrationVirtualNetwork

이 DNS 영역에 가상 머신 호스트 이름 레코드를 등록할 가상 네트워크 목록이며 프라이빗 영역에만 사용할 수 있습니다.

형식:List<T>[IResourceReference]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-RegistrationVirtualNetworkId

이 DNS 영역에 가상 머신 호스트 이름 레코드를 등록할 가상 네트워크 ID 목록이며 프라이빗 영역에만 사용할 수 있습니다.

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

-ResolutionVirtualNetwork

이 DNS 영역에서 레코드를 확인할 수 있는 가상 네트워크 목록으로, 프라이빗 영역에만 사용할 수 있습니다.

형식:List<T>[IResourceReference]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResolutionVirtualNetworkId

이 DNS 영역에서 레코드를 확인할 수 있는 가상 네트워크 ID 목록으로, 프라이빗 영역에만 사용할 수 있습니다.

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

-ResourceGroupName

영역을 만들 리소스 그룹을 지정합니다.

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

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다. cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

-ZoneType

영역, 공용 또는 프라이빗의 형식입니다. 형식이 없거나 공용 형식이 있는 영역은 DNS 계층 구조에서 사용할 수 있도록 공용 DNS 서비스 평면에서 사용할 수 있습니다. 프라이빗 유형이 있는 영역은 연결된 가상 네트워크 집합에서만 볼 수 있습니다(이 기능은 미리 보기 상태임). 영역에 대해 이 속성을 변경할 수 없습니다.

형식:Nullable<T>[ZoneType]
허용되는 값:Public, Private
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.ZoneType, Microsoft.Azure.Management.Dns, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

출력

DnsZone

참고

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