Remove-AzDnsZone
Odebere zónu DNS ze skupiny prostředků.
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
Rutina Remove-AzDnsZone trvale odstraní zónu DNS (Domain Name System) ze zadané skupiny prostředků. Odstraní se také všechny sady záznamů obsažené v zóně. Objekt DnsZone můžete předat pomocí parametru Name nebo pomocí operátoru kanálu nebo případně zadat parametry ZoneName a ResourceGroupName. Pomocí parametru Confirm a $ConfirmPreference proměnné Prostředí Windows PowerShell můžete určit, jestli vás rutina vyzve k potvrzení. Při zadávání zóny pomocí objektu DnsZone (předaného prostřednictvím parametru kanálu nebo zóny ) se zóna neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu DnsZone (operace přímo s prostředkem zóny DNS se počítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsání , který odstraní zónu bez ohledu na souběžné změny.
Příklady
Příklad 1: Odebrání zóny
Remove-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
Tento příkaz odebere zónu s názvem myzone.com ze skupiny prostředků MyResourceGroup.
Parametry
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Určuje název zóny DNS, kterou tato rutina odebere. Musíte také zadat parametr ResourceGroupName . Případně můžete zónu DNS zadat pomocí parametru Zone .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Overwrite
Při zadávání zóny pomocí objektu DnsZone (předaného prostřednictvím parametru kanálu nebo zóny ) se zóna neodstraní, pokud byla změněna v Azure DNS od načtení místního objektu DnsZone (operace přímo s prostředkem zóny DNS se počítají jako změny, operace se sadami záznamů v rámci zóny ne). To poskytuje ochranu pro souběžné změny zóny. To lze potlačit pomocí parametru Přepsání , který odstraní zónu bez ohledu na souběžné změny.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
passthru
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Určuje název skupiny prostředků, která obsahuje zónu, kterou chcete odebrat. Musíte také zadat parametr ZoneName . Alternativně můžete určit zónu DNS pomocí objektu DnsZone předaného prostřednictvím kanálu nebo parametru Zone .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Určuje zónu DNS, která se má odstranit. Předávaný objekt DnsZone lze také předat prostřednictvím kanálu. Případně můžete určit zónu DNS, kterou chcete odstranit, pomocí parametrů ZoneName a ResourceGroupName .
Type: | DnsZone |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Vstupy
Výstupy
Poznámky
Vzhledem k potenciálně vysokému dopadu odstranění zóny DNS tato rutina ve výchozím nastavení vyzve k potvrzení, pokud má proměnná $ConfirmPreference Windows PowerShell jinou hodnotu než None. Pokud zadáte Potvrdit nebo Potvrdit:$True, zobrazí se tato rutina před spuštěním výzvy k potvrzení. Pokud zadáte Confirm :$False, rutina vás k potvrzení nezobrazí.