Remove-AzDnsZone

模組:
Az.Dns Module

從資源群組移除 DNS 區域。

語法

Fields 

Remove-AzDnsZone
    -Name <String>
    -ResourceGroupName <String>
    [-PassThru]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Object 

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

Description

Remove-AzDnsZone Cmdlet 會從指定的資源群組永久刪除網域名稱系統 （DNS） 區域。 區域中包含的所有記錄集也會被刪除。 您可以使用 Name 參數或使用管線運算子來傳遞 DnsZone 物件，或者您可以指定 ZoneName 和 ResourceGroupName 參數。 你可以使用 Confirm 參數和 $ConfirmPreference Windows PowerShell 變數來控制 cmdlet 是否會提示你確認。 當使用 DnsZone物件（經由管線或 Zone參數傳遞）指定區域時，若區域在Azure DNS中自本地 DnsZone物件被取得後已變更，則該區域不會被刪除（僅直接對 DNS 區域資源的操作視為變更， 區域內的記錄集操作則不然）。 這為並行區域變更提供保護。 可以使用 Overwrite 參數來抑制此情況，無論並行變更為何，都會刪除區域。

範例

範例 1：移除區域

Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

此命令會從名為 MyResourceGroup 的資源群組中移除名為 myzone.com 的區域。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此 Cmdlet 移除的 DNS 區域名稱。 您也必須指定 ResourceGroupName 參數。 或者，您可以使用 Zone 參數指定 DNS 區域。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Fields
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Overwrite

當使用 DnsZone物件（經由管線或 Zone參數傳遞）指定區域時，若區域在Azure DNS中自本地 DnsZone物件被取得後已變更，則該區域不會被刪除（僅直接對 DNS 區域資源的操作視為變更， 區域內的記錄集操作則不然）。 這為並行區域變更提供保護。 可以使用 Overwrite 參數來抑制此情況，無論並行變更為何，都會刪除區域。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Object
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PassThru

直通

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

指定包含要移除之區域的資源群組名稱。 您也必須指定 ZoneName 參數。 或者，您可以使用 DnsZone 物件來指定 DNS 區域，透過管線或 Zone 參數傳遞。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Fields
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Zone

指定要刪除的 DNS 區域。 傳遞的 DnsZone 物件也可以透過管線傳遞。 或者，您可以使用 ZoneName 和 ResourceGroupName 參數來指定要刪除的 DNS 區域。

參數屬性

類型:DnsZone
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Object
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

DnsZone

輸出

Boolean

備註

由於刪除 DNS 區域可能帶來極大影響，預設情況下，此指令檔會提示確認 $ConfirmPreference Windows PowerShell 變數是否有除 None 以外的值。 如果您指定 [確認] 或 [確認：$True]，此 Cmdlet 會在執行之前提示您確認。 如果您指定 Confirm：$False，Cmdlet 不會提示您確認。