Share via

Set-AzDnsZone

  • 參考
模組:
Az.Dns

更新 DNS 區域的屬性。

Syntax

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 區域當做對象傳遞時（使用 Zone 物件或透過管線），如果已在 Azure DNS 中變更，則會在擷取本機 DnsZone 物件之後更新它。 這會為並行變更提供保護。 您可以使用 Overwrite 參數隱藏此行為，不論並行變更為何，都會更新區域。

範例

範例 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：藉由指定其標識碼，將私人區域與虛擬網路產生關聯

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

此命令會藉由指定其標識碼，將 私用 DNS 區域 myprivatezone.com 與虛擬網路 myvnet 建立關聯，作為註冊網路。

範例 4：藉由指定網路物件，將私人區域與虛擬網路產生關聯。

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

此命令會將 私用 DNS 區域 myprivatezone.com 與虛擬網路 myvnet 建立關聯，方法是將 $vnet 變數所代表的虛擬網路對象傳遞至 Set-AzDnsZone Cmdlet。

參數

-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

指定要更新的 DNS 區域名稱。

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

-Overwrite

當將 DNS 區域當做對象傳遞時（使用 Zone 物件或透過管線），如果已在 Azure DNS 中變更，則會在擷取本機 DnsZone 物件之後更新它。 這會為並行變更提供保護。 您可以使用 Overwrite 參數隱藏此行為，不論並行變更為何，都會更新區域。

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

-RegistrationVirtualNetwork

將在此 DNS 區域中註冊虛擬機主機名記錄的虛擬網路清單，僅適用於私人區域。

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RegistrationVirtualNetworkId

將在此 DNS 區域中註冊虛擬機主機名記錄的虛擬網路識別碼清單，僅適用於私人區域。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetwork

能夠解析此 DNS 區域中記錄的虛擬網路清單，僅適用於私人區域。

Type:List<T>[IResourceReference]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResolutionVirtualNetworkId

虛擬網路標識碼清單能夠解析此 DNS 區域中的記錄，僅適用於私人區域。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定要更新之區域的資源群組名稱。 您也必須指定 ZoneName 參數。 或者，您可以使用 DnsZone 物件搭配 Zone 參數或管線來指定區域。

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

-Tag

哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。顯示 Cmdlet 執行時會發生什麼事。 未執行 Cmdlet。

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

-Zone

指定要更新的 DNS 區域。 或者，您可以使用 ZoneName 和 ResourceGroupName 參數來指定區域。

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 變數的值是否為 Medium 或更低。 如果您指定 Confirm 或 Confirm：$True，此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm：$False，Cmdlet 不會提示您進行確認。