Set-AzDnsZone
更新 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 區域當做對象傳遞時（使用 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)此命令會將 $vnet 變數所代表的虛擬網路對象傳遞至 Set-AzDnsZone Cmdlet，將私人 DNS 區域 myprivatezone.com 與虛擬網路 myvnet 建立關聯作為註冊網路。
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定要更新的 DNS 區域名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Overwrite
當將 DNS 區域當做對象傳遞時（使用 Zone 物件或透過管線），如果已在 Azure DNS 中變更，則會在擷取本機 DnsZone 物件之後更新它。 這會為並行變更提供保護。 您可以使用 Overwrite 參數來隱藏此行為，不論並行變更為何，都會更新區域。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RegistrationVirtualNetwork
將在此 DNS 區域中註冊虛擬機主機名記錄的虛擬網路清單，僅適用於私人區域。
| 類型: | List<T>[IResourceReference] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-RegistrationVirtualNetworkId
將在此 DNS 區域中註冊虛擬機主機名記錄的虛擬網路識別碼清單，僅適用於私人區域。
| 類型: | List<T>[String] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResolutionVirtualNetwork
能夠解析此 DNS 區域中記錄的虛擬網路清單，僅適用於私人區域。
| 類型: | List<T>[IResourceReference] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResolutionVirtualNetworkId
虛擬網路標識碼清單能夠解析此 DNS 區域中的記錄，僅適用於私人區域。
| 類型: | List<T>[String] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
指定要更新之區域的資源群組名稱。 您也必須指定 ZoneName 參數。 或者，您可以使用 DnsZone 物件搭配 Zone 參數或管線來指定區域。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Tag
哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}
| 類型: | Hashtable |
| 別名: | Tags |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Zone
指定要更新的 DNS 區域。 或者，您可以使用 ZoneName 和 ResourceGroupName 參數來指定區域。
| 類型: | DnsZone |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
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]]
輸出
備註
您可以使用 Confirm 參數來控制此 Cmdlet 是否提示您進行確認。 根據預設，Cmdlet 會提示您確認$ConfirmPreference Windows PowerShell 變數的值是否為 Medium 或更低。 如果您指定 Confirm 或 Confirm：$True，此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm：$False，Cmdlet 不會提示您進行確認。