Como gerenciar as zonas DNS usando o PowerShell

Este artigo mostra como gerenciar suas zonas DNS usando o Azure PowerShell. Você também pode gerenciar as zonas DNS usando a plataforma cruzada CLI do Azure ou o portal do Azure.

Este guia trata especificamente das zonas DNS públicas. Para obter informações sobre como usar o Azure PowerShell para gerenciar Zonas Privadas no DNS do Azure, consulte Introdução às Zonas Privadas do DNS do Azure usando o Azure PowerShell.

Uma zona DNS é usada para hospedar os registros DNS para um domínio específico. Para iniciar a hospedagem do seu domínio no DNS do Azure, você precisará criar uma zona DNS para esse nome de domínio. Cada registro DNS para seu domínio é criado dentro dessa zona DNS.

Por exemplo, o domínio 'contoso.com' pode conter vários registros DNS, como 'mail.contoso.com' (para um servidor de email) e 'www.contoso.com' (para um site da Web).

Ao criar uma zona DNS no DNS do Azure:

• O nome da zona deve ser exclusivo dentro do grupo de recursos e a zona não deve existir ainda. Caso contrário, a operação falhará.
• O mesmo nome de zona pode ser reutilizado em outro grupo de recursos ou uma assinatura do Azure diferente.
• Quando várias zonas têm o mesmo nome, cada instância recebe endereços de servidor de nomes diferentes. Apenas um conjunto de endereços pode ser configurado com o registrador de nome de domínio.

Configurar o Azure PowerShell para DNS do Azure

Antes de começar

Antes de começar a configurar, verifique se você tem os itens a seguir.

• Uma assinatura do Azure. Se ainda não tiver uma assinatura do Azure, você poderá ativar os Benefícios do assinante do MSDN ou inscrever-se para obter uma conta gratuita.
• Você precisa instalar a versão mais recente dos cmdlets do Azure Resource Manager do PowerShell. Para obter mais informações, confira Como instalar e configurar o Azure PowerShell.

Entre na sua conta do Azure

Abra o console do PowerShell e conecte-se à sua conta. Para obter mais informações, veja Entrar com o Azure PowerShell.

Connect-AzAccount

Selecionar a assinatura

Verificar as assinaturas da conta.

Get-AzSubscription

Escolha quais das suas assinaturas do Azure deseja usar.

Select-AzSubscription -SubscriptionName "your_subscription_name"

Criar um grupo de recursos

O Azure Resource Manager requer que todos os grupos de recursos especifiquem um local. Esse local é usado como o local padrão para os recursos do grupo de recursos em questão. No entanto, como todos os recursos de DNS são globais, não regionais, a escolha do local do grupo de recursos não afeta o DNS do Azure.

Você pode ignorar esta etapa se está usando um grupo de recursos existente.

New-AzResourceGroup -Name MyDNSResourceGroup -location "West US"

Criar uma zona DNS

Uma zona DNS é criada usando o cmdlet New-AzDnsZone .

O seguinte exemplo cria uma zona DNS chamada contoso.com no grupo de recursos chamado MyDNSResourceGroup:

New-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup

O exemplo a seguir mostra como criar uma zona DNS com duas marcas do Azure Resource Manager, project = demo e env = test:

New-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup -Tag @{ project="demo"; env="test" }

Obter uma zona DNS

Para recuperar uma zona DNS, use o cmdlet Get-AzDnsZone . Esta operação retornará um objeto de zona DNS correspondente a uma zona existente no DNS do Azure. O objeto contém dados sobre a zona (como o número de conjuntos de registros), mas não contém os conjuntos de registro em si (confira Get-AzDnsRecordSet).

Get-AzDnsZone -Name contoso.com –ResourceGroupName MyDNSResourceGroup

Name                  : contoso.com
ResourceGroupName     : myresourcegroup
Etag                  : 00000003-0000-0000-8ec2-f4879750d201
Tags                  : {project, env}
NameServers           : {ns1-01.azure-dns.com., ns2-01.azure-dns.net., ns3-01.azure-dns.org.,
                        ns4-01.azure-dns.info.}
NumberOfRecordSets    : 2
MaxNumberOfRecordSets : 5000

Listar as zonas DNS

Omitindo o nome da zona de Get-AzDnsZone, você pode enumerar todas as zonas em um grupo de recursos. Essa operação retorna uma matriz de objetos de zona.

$zoneList = Get-AzDnsZone -ResourceGroupName MyDNSResourceGroup
$zoneList

Omitindo o nome da zona e o nome do grupo de recursos do Get-AzDnsZone, você pode enumerar todas as regiões na assinatura do Azure.

$zoneList = Get-AzDnsZone
$zoneList

Atualizar uma zona DNS

As alterações a um recurso da zona DNS podem ser feitas usando o Set-AzDnsZone. Este cmdlet não atualiza nenhum dos conjuntos de registros DNS dentro da zona (confira Como gerenciar registros DNS). Ele só é usado para atualizar as propriedades do recurso da zona em si. As propriedades de zona graváveis são limitadas às ‘marcas’ do Azure Resource Manager para o recurso de zona.

Use um dos dois métodos a seguir para atualizar uma zona DNS:

Especifique a zona usando o nome da zona e o grupo de recursos

Essa abordagem substitui as marcas de zona existente com os valores especificados.

Set-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup -Tag @{ project="demo"; env="test" }

Especifique a zona usando um objeto de $zone

Essa abordagem recupera o objeto de zona existente, modifica as marcas e, em seguida, confirma as alterações. Dessa forma, as marcas existentes podem ser preservadas.

# Get the zone object
$zone = Get-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup

# Remove an existing tag
$zone.Tags.Remove("project")

# Add a new tag
$zone.Tags.Add("status","approved")

# Commit changes
Set-AzDnsZone -Zone $zone

Ao usar Set-AzDnsZone com um objeto $zone, verificações de Etag serão usadas para garantir que as alterações simultâneas não sejam substituídas. Você pode usar o argumento -Overwrite opcional para omitir essas verificações.

Excluir uma zona DNS

As zonas DNS podem ser excluídas usando o cmdlet Remove-AzDnsZone.

Use um dos dois métodos a seguir para excluir uma zona DNS:

Especifique a zona usando o nome da zona e o nome do grupo de recursos

Remove-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup

Especifique a zona usando um objeto de $zone

Você pode especificar a zona a ser excluído usando um $zone objeto retornado por Get-AzDnsZone.

$zone = Get-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup
Remove-AzDnsZone -Zone $zone

O objeto de zona também pode ser redirecionado em vez de ser passado como um parâmetro:

Get-AzDnsZone -Name contoso.com -ResourceGroupName MyDNSResourceGroup | Remove-AzDnsZone

Assim como com Set-AzDnsZone, especificar a zona usando um objeto $zone habilita as verificações de Etag para garantir que as alterações simultâneas não sejam excluídas. Use o -Overwrite para suprimir essas verificações.

Prompts de confirmação

Os cmdlets New-AzDnsZone, Set-AzDnsZone e Remove-AzDnsZone oferecem suporte aos prompts de confirmação.

New-AzDnsZone e Set-AzDnsZone solicitam confirmação caso a variável de preferência do PowerShell $ConfirmPreference tenha um valor Medium ou inferior. Como a exclusão de uma zona DNS pode causar condições indesejadas, o cmdlet Remove-AzDnsZone solicitará a confirmação se a variável $ConfirmPreference do PowerShell tiver um valor diferente de None.

Desde o valor padrão para $ConfirmPreference é High, apenas Remove-AzDnsZone solicitará uma confirmação por padrão.

Você pode substituir a configuração $ConfirmPreference atual usando o parâmetro -Confirm. Se você especificar -Confirm ou -Confirm:$True, o cmdlet solicitará uma confirmação antes de executar. Se você especificar -Confirm:$False, o cmdlet não solicitará uma confirmação.

Para obter mais informações sobre -Confirm e $ConfirmPreference, consulte Sobre as Variáveis de Preferência.

Próximas etapas

Saiba como gerenciar conjuntos de registros e registros em sua zona DNS.
Saiba como delegar seu domínio ao DNS do Azure.
Examine a documentação de referência do PowerShell do DNS do Azure.