Remove-AzDnsZone
Tar bort en DNS-zon från en resursgrupp.
Syntax
Remove-AzDnsZone
-Name <String>
-ResourceGroupName <String>
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzDnsZone
-Zone <DnsZone>
[-Overwrite]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Remove-AzDnsZone tar permanent bort en DNS-zon (Domain Name System) från en angiven resursgrupp. Alla postuppsättningar som finns i zonen tas också bort. Du kan skicka ett DnsZone-objekt med hjälp av parametern Namn eller med hjälp av pipelineoperatorn, eller så kan du ange parametrarna ZoneName och ResourceGroupName . Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. När du anger zonen med ett DnsZone-objekt (som skickas via pipelinen eller zonparametern ) tas inte zonen bort om den har ändrats i Azure DNS sedan det lokala DnsZone-objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen gör det inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med parametern Skriv över , vilket tar bort zonen oavsett samtidiga ändringar.
Exempel
Exempel 1: Ta bort en zon
Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
Det här kommandot tar bort zonen med namnet myzone.com från resursgruppen med namnet MyResourceGroup.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Typ: | SwitchParameter |
Alias: | cf |
Position: | Named |
Standardvärde: | False |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure
Typ: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Name
Anger namnet på DNS-zonen som den här cmdleten tar bort. Du måste också ange parametern ResourceGroupName . Du kan också ange DNS-zonen med hjälp av parametern Zon .
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-Overwrite
När du anger zonen med ett DnsZone-objekt (som skickas via pipelinen eller zonparametern ) tas inte zonen bort om den har ändrats i Azure DNS sedan det lokala DnsZone-objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen gör det inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med parametern Skriv över , vilket tar bort zonen oavsett samtidiga ändringar.
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-PassThru
passthru
Typ: | SwitchParameter |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-ResourceGroupName
Anger namnet på resursgruppen som innehåller den zon som ska tas bort. Du måste också ange parametern ZoneName . Du kan också ange DNS-zonen med hjälp av ett DnsZone-objekt som skickas via pipelinen eller parametern Zone .
Typ: | String |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Typ: | SwitchParameter |
Alias: | wi |
Position: | Named |
Standardvärde: | False |
Obligatorisk: | False |
Godkänn pipeline-indata: | False |
Godkänn jokertecken: | False |
-Zone
Anger dns-zonen som ska tas bort. DnsZone-objektet som skickas kan också skickas via pipelinen. Du kan också ange den DNS-zon som ska tas bort med hjälp av parametrarna ZoneName och ResourceGroupName .
Typ: | DnsZone |
Position: | Named |
Standardvärde: | None |
Obligatorisk: | True |
Godkänn pipeline-indata: | True |
Godkänn jokertecken: | False |
Indata
Utdata
Kommentarer
På grund av den potentiellt höga effekten av att ta bort en DNS-zon uppmanas den här cmdleten som standard att bekräfta om $ConfirmPreference Windows PowerShell-variabeln har något annat värde än Inget. Om du anger Bekräfta eller Bekräfta:$True uppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$False uppmanas du inte att bekräfta cmdleten.