Set-AzDnsZone

모듈:

Az.Dns

DNS 영역의 속성을 업데이트합니다.

구문

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-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>]

Set-AzDnsZone
   -Zone <DnsZone>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzDnsZone cmdlet은 Azure DNS 서비스에서 지정된 DNS 영역을 업데이트합니다. 이 cmdlet은 영역의 레코드 집합을 업데이트하지 않습니다. DnsZone 개체를 매개 변수로 전달하거나 파이프라인 연산자를 사용하여 전달하거나 ZoneName 및 ResourceGroupName 매개 변수를 지정할 수 있습니다. Confirm 매개 변수 및 $ConfirmPreference Windows PowerShell 변수를 사용하여 cmdlet에서 확인 메시지를 표시할지 여부를 제어할 수 있습니다. DNS 영역을 개체로 전달하는 경우(영역 개체를 사용하거나 파이프라인을 통해) 로컬 DnsZone 개체가 검색된 이후 Azure DNS에서 변경된 경우 업데이트되지 않습니다. 이렇게 하면 동시 변경 내용에 대한 보호가 제공됩니다. 동시 변경 내용에 관계없이 영역을 업데이트하는 덮어쓰기 매개 변수를 사용하여 이 동작을 표시하지 않을 수 있습니다.

예제

예제 1: DNS 영역 업데이트

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

첫 번째 명령은 지정된 리소스 그룹에서 myzone.com 명명된 영역을 가져오고 $Zone 변수에 저장합니다. 두 번째 명령은 $Zone 대한 태그를 업데이트합니다. 최종 명령은 변경 내용을 커밋합니다.

예제 2: 영역에 대한 태그 업데이트

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

이 명령은 영역을 명시적으로 가져오지 않고 myzone.com 영역에 대한 태그를 업데이트합니다.

예제 3: ID를 지정하여 프라이빗 영역을 가상 네트워크와 연결

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

이 명령은 ID를 지정하여 프라이빗 DNS 영역 myprivatezone.com 가상 네트워크 myvnet을 등록 네트워크로 연결합니다.

예제 4: 네트워크 개체를 지정하여 프라이빗 영역을 가상 네트워크와 연결합니다.

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

이 명령은 $vnet 변수로 표시되는 가상 네트워크 개체를 Set-AzDnsZone cmdlet에 전달하여 프라이빗 DNS 영역 myprivatezone.com 가상 네트워크 myvnet을 등록 네트워크로 연결합니다.

매개 변수

-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

-Overwrite

DNS 영역을 개체로 전달하는 경우(영역 개체를 사용하거나 파이프라인을 통해) 로컬 DnsZone 개체가 검색된 이후 Azure DNS에서 변경된 경우 업데이트되지 않습니다. 이렇게 하면 동시 변경 내용에 대한 보호가 제공됩니다. 동시 변경 내용에 관계없이 영역을 업데이트하는 덮어쓰기 매개 변수를 사용하여 이 동작을 표시하지 않을 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	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

업데이트할 영역을 포함하는 리소스 그룹의 이름을 지정합니다. ZoneName 매개 변수도 지정해야 합니다. 또는 Zone 매개 변수 또는 파이프라인과 함께 DnsZone 개체를 사용하여 영역을 지정할 수 있습니다.

형식:	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

-Zone

업데이트할 DNS 영역을 지정합니다. 또는 ZoneName 및 ResourceGroupName 매개 변수를 사용하여 영역을 지정할 수 있습니다.

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

입력

String

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

출력

DnsZone

참고

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

관련 링크

• Get-AzDnsZone
• New-AzDnsZone
• Remove-AzDnsZone