Guia para criar uma VM do SQL Server com o PowerShell
Aplica-se a: SQL Server na VM do Azure
Este guia aborda as opções de uso do PowerShell para criar um SQL Server na Máquina Virtual (VM) do Azure. Para obter um exemplo simplificado do Azure PowerShell que depende de valores padrão, confira o Início rápido do SQL Server na VM do Azure com PowerShell ou, para obter um script de ponta a ponta, confira Script para criar uma VM do SQL Server com o PowerShell.
Pré-requisitos
Para executar este guia, você deve ter o seguinte:
- Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
- A última versão do Azure PowerShell
Observação
Este artigo usa o módulo do PowerShell Azure Az, que é o módulo do PowerShell recomendado para interagir com o Azure. Para começar a usar o módulo do Az PowerShell, confira Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.
Definir variáveis
Para reutilizar valores e simplificar a criação do script, comece definindo um número de variáveis. Altere os valores de parâmetro como desejar, mas lembre-se das restrições de nomenclatura relacionadas a tamanhos de nome e a caracteres especiais ao modificar os valores fornecidos.
Comece definindo os parâmetros a serem usados ao longo do script, como o local, o nome do grupo de recursos, a imagem do SQL Server e a conta de armazenamento que você quer usar, além das propriedades da rede e da máquina virtual.
Local e grupo de recursos
Defina a região de dados, o grupo de recursos e a assinatura nos quais você quer criar sua VM do SQL Server e os recursos associados a ela.
Modifique conforme desejado e, em seguida, execute estes cmdlets para iniciar essas variáveis.
$SubscriptionId = "<Enter Subscription ID>"
$Location = "<Enter Location>"
$ResourceGroupName = "<Enter Resource Group Name>"
$userName = "<Enter User Name for the virtual machine"
Propriedades de armazenamento
Defina a conta de armazenamento e o tipo de armazenamento a usar na máquina virtual.
Modifique conforme desejado e, então, execute o cmdlet a seguir para iniciar essas variáveis. É recomendável utilizar os SSDs Premium para cargas de trabalho de produção.
$StorageName = "sqlvm" + "storage"
$StorageSku = "Premium_LRS"
Observação
O nome da conta de armazenamento deve ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas, então certifique-se de que o nome do seu grupo de recursos não tenha caracteres especiais, ou modifique o nome da conta de armazenamento para usar um nome diferente de $ResourceGroupName.
Propriedades de rede
Defina as propriedades a usadas pela rede na máquina virtual.
- interface de rede
- Método de alocação de TCP/IP
- Nome da rede virtual
- Nome da sub-rede virtual
- Intervalo de endereços IP para a rede virtual
- Intervalo de endereços IP para a sub-rede
- Rótulo do nome de domínio público
Modifique conforme desejado e, em seguida, execute este cmdlet para iniciar essas variáveis.
$InterfaceName = $ResourceGroupName + "ServerInterface"
$NsgName = $ResourceGroupName + "nsg"
$TCPIPAllocationMethod = "Dynamic"
$VNetName = $ResourceGroupName + "VNet"
$SubnetName = "Default"
$VNetAddressPrefix = "10.0.0.0/16"
$VNetSubnetAddressPrefix = "10.0.0.0/24"
$DomainName = $ResourceGroupName
Propriedades de máquina virtual
Defina as propriedades a seguir:
- Nome da máquina virtual
- Nome do computador
- Tamanho da máquina virtual
- Nome do disco do sistema operacional para a máquina virtual
Modifique conforme desejado e, em seguida, execute este cmdlet para iniciar essas variáveis.
$VMName = $ResourceGroupName + "VM"
$ComputerName = $ResourceGroupName + "Server"
$VMSize = "Standard_DS13"
$OSDiskName = $VMName + "OSDisk"
Escolha uma imagem do SQL Server
É possível implantar uma imagem mais antiga do SQL Server que não esteja disponível no portal do Azure usando o PowerShell.
Use as seguintes variáveis para definir a imagem do SQL Server a ser usada para a máquina virtual.
Liste todas as ofertas de imagem do SQL Server no comando Get-AzVMImageOffer para listar as imagens disponíveis atualmente no portal do Azure, além de imagens mais antigas que você só pode implantar com o PowerShell:
Get-AzVMImageOffer -Location $Location -Publisher 'MicrosoftSQLServer'
Observação
O SQL Server 2008 e o SQL Server 2008 R2 estão fora do suporte estendido e não estão mais disponíveis no Azure Marketplace.
Liste as edições disponíveis para a sua oferta no Get-AzVMImageSku.
Get-AzVMImageSku -Location $Location -Publisher 'MicrosoftSQLServer' -Offer $OfferName | Select Skus
Para este tutorial, use o SQL Server 2022 Developer Edition (SQLDEV-GEN2) no Windows Server 2022. A Developer Edition é licenciada gratuitamente para fins de teste e desenvolvimento; você só paga o custo de execução da VM:
$OfferName = "SQL2022-WS2022"
$PublisherName = "MicrosoftSQLServer"
$Version = "latest"
$Sku = "SQLDEV-GEN2"
$License = 'PAYG'
# Define a credential object
$SecurePassword = ConvertTo-SecureString '<strong password>' `
-AsPlainText -Force
$Cred = New-Object System.Management.Automation.PSCredential ($userName, $securePassword)
Criar um grupo de recursos
Abra o PowerShell e estabeleça o acesso à sua conta do Azure executando o comando Connect-AzAccount; defina seu contexto de assinatura com Set-AzContext. Insira suas credenciais quando solicitado. Use o mesmo email e senha usados para entrar no Portal do Azure.
Após estabelecer o contexto da assinatura, o primeiro objeto que você vai criar é o grupo de recursos. Use o comando Connect-AzAccount para se conectar ao Azure e defina o contexto da sua assinatura com Set-AzContext. Use o cmdlet New-AzResourceGroup para criar um grupo de recursos do Azure e seus recursos. Especifique as variáveis iniciadas anteriormente para o nome e o local do grupo de recursos.
Execute esse cmdlet para se conectar ao Azure, estabelecer o contexto de assinatura e criar seu novo grupo de recursos:
# Set subscription context
Connect-AzAccount
$subscriptionContextParams = @{
SubscriptionId = $SubscriptionId
}
Set-AzContext @subscriptionContextParams
# Create a resource group
$resourceGroupParams = @{
Name = $resourceGroupName
Location = $Location
Tag = @{Owner="SQLDocs-Samples"}
}
$resourceGroup = New-AzResourceGroup @resourceGroupParams
Criar uma conta de armazenamento
A máquina virtual exige recursos de armazenamento para o disco do sistema operacional para os arquivos de log de dados do SQL Server. Para simplificar, você criará um único disco para ambos. É possível anexar discos adicionais posteriormente usando o cmdlet Add-Azure Disk para colocar seus dados do SQL Server e os arquivo de log em discos dedicados. Use o cmdlet New-AzStorageAccount para criar uma conta de Armazenamento Standard em seu novo grupo de recursos. Especifique as variáveis iniciadas anteriormente para o nome de conta de armazenamento, nome do SKU de armazenamento e local.
Execute esse cmdlet para criar sua nova conta de armazenamento:
# Create storage account
$StorageAccount = New-AzStorageAccount -ResourceGroupName $ResourceGroupName `
-Name $StorageName -SkuName $StorageSku `
-Kind "Storage" -Location $Location
Dica
Criar uma conta de armazenamento pode demorar alguns minutos.
Criar recursos da rede
A máquina virtual requer um número de recursos de rede para conectividade de rede.
- Cada máquina virtual exige um rede virtual.
- Uma rede virtual deve ter pelo menos uma sub-rede definida.
- Uma interface de rede deve ser definida com um público ou um endereço IP privado.
Criar uma configuração de sub-rede da rede virtual
Comece criando uma configuração de sub-rede para a sua rede virtual. Para este tutorial, crie uma sub-rede padrão usando o cmdlet New-AzVirtualNetworkSubnetConfig. Especifique as variáveis iniciadas anteriormente para o nome de sub-rede e o prefixo de endereço.
Observação
Você pode definir propriedades adicionais da configuração de sub-rede da rede virtual usando esse cmdlet, mas isso está além do escopo deste tutorial.
Execute este cmdlet para criar a configuração de sub-rede virtual.
# Create a subnet configuration
$SubnetConfig = New-AzVirtualNetworkSubnetConfig -Name $SubnetName -AddressPrefix $VNetSubnetAddressPrefix
Criar uma rede virtual
Em seguida, crie sua rede virtual no grupo de recursos usando o cmdlet New-AzVirtualNetwork. Especifique as variáveis iniciadas anteriormente para nome, local e prefixo de endereço. Use a configuração de sub-rede definida na etapa anterior.
Execute esse cmdlet para criar sua rede virtual:
# Create a virtual network
$VNet = New-AzVirtualNetwork -Name $VNetName `
-ResourceGroupName $ResourceGroupName -Location $Location `
-AddressPrefix $VNetAddressPrefix -Subnet $SubnetConfig
Criar um endereço IP público
Agora que sua rede virtual está definida, você precisa configurar um endereço IP para se conectar à máquina virtual. Para este tutorial, crie um endereço IP público usando o endereçamento IP dinâmico para dar suporte à conectividade de Internet. Use o cmdlet New-AzPublicIpAddress para criar o endereço IP público em seu novo grupo de recursos. Especifique as variáveis iniciadas anteriormente para nome, local, método de alocação e rótulo do nome de domínio DNS.
Observação
Você pode definir propriedades adicionais do endereço IP público usando esse cmdlet, mas isso está além do escopo deste tutorial. Você também pode criar um endereço particular ou um endereço com um endereço estático, mas isso também está além do escopo deste tutorial.
Execute este cmdlet para criar seu endereço IP público.
# Create a public IP address
$PublicIp = New-AzPublicIpAddress -Name $InterfaceName `
-ResourceGroupName $ResourceGroupName -Location $Location `
-AllocationMethod $TCPIPAllocationMethod -DomainNameLabel $DomainName
Crie o grupo de segurança de rede
Para proteger o tráfego do SQL Server e da VM, cria um grupo de segurança de rede.
Crie duas regras de grupo de segurança de rede usando New-AzNetworkSecurityRuleConfig, uma regra para a área de trabalho remota (RDP), para permitir conexões RDP, e uma regra que permita tráfego na porta TCP 1433. Fazer isso habilita as conexões ao SQL Server pela Internet.
# Create a network security group rule $NsgRuleRDP = New-AzNetworkSecurityRuleConfig -Name "RDPRule" -Protocol Tcp ` -Direction Inbound -Priority 1000 -SourceAddressPrefix * -SourcePortRange * ` -DestinationAddressPrefix * -DestinationPortRange 3389 -Access Allow $NsgRuleSQL = New-AzNetworkSecurityRuleConfig -Name "MSSQLRule" -Protocol Tcp ` -Direction Inbound -Priority 1001 -SourceAddressPrefix * -SourcePortRange * ` -DestinationAddressPrefix * -DestinationPortRange 1433 -Access Allow
Crie o grupo de segurança de rede usando New-AzNetworkSecurityGroup.
# Create a network security group $Nsg = New-AzNetworkSecurityGroup -ResourceGroupName $ResourceGroupName ` -Location $Location -Name $NsgName ` -SecurityRules $NsgRuleRDP,$NsgRuleSQL
Criar a interface de rede
Agora você está pronto para criar a interface de rede para sua máquina virtual. Use o cmdlet New-AzNetworkInterface para criar o adaptador de rede no novo grupo de recursos. Especifique o nome, o local, a sub-rede e o endereço IP público definidos anteriormente.
Execute este cmdlet para criar a interface de rede.
# Create a network interface
$Interface = New-AzNetworkInterface -Name $InterfaceName `
-ResourceGroupName $ResourceGroupName -Location $Location `
-SubnetId $VNet.Subnets[0].Id -PublicIpAddressId $PublicIp.Id `
-NetworkSecurityGroupId $Nsg.Id
Configurar um objeto da VM
Agora que os recursos de rede e de armazenamento estão definidos, está tudo pronto para definir os recursos de computação para a máquina virtual.
- Especifique o tamanho da máquina virtual e as várias propriedades do sistema operacional.
- Especifique a interface de rede criada anteriormente.
- Defina o armazenamento de blob.
- Especifique o disco do sistema operacional.
Criar a VM do SQL Server
Para criar sua VM do SQL Server, primeiro crie um objeto de credencial e, a seguir, crie a VM.
Criar um objeto de credencial para armazenar o nome e a senha para as credenciais de administrador local
Antes de definir as propriedades de sistema operacional da máquina virtual, é preciso fornecer as credenciais da conta de administrador local como uma cadeia de caracteres segura. Para fazer isso, usamos o cmdlet Get-Credential.
Execute o cmdlet a seguir. Você precisará digitar o nome do administrador local e a senha da VM na janela de solicitação de credenciais do PowerShell.
# Define a credential object
$SecurePassword = ConvertTo-SecureString '<strong password>' `
-AsPlainText -Force
$Cred = New-Object System.Management.Automation.PSCredential ($userName, $securePassword)
Definir propriedades e criar a VM
Agora você está pronto para definir as propriedades do sistema operacional da máquina virtual com New-AzVMConfig, criar a VM com New-AzVM e usar o cmdlet Add-AzVMNetworkInterface para adicionar a interface de rede usando a variável que você definiu anteriormente.
A amostra de script faz o seguinte:
- Exija que o agente de máquina virtual seja instalado.
- Especifica que o cmdlet habilita a atualização automática.
- Especifica as variáveis que você inicializou anteriormente para o nome da máquina virtual, o nome do computador e a credencial.
Execute este cmdlet para definir as propriedades do sistema operacional de sua máquina virtual.
# Create a virtual machine configuration
$VMName = $ResourceGroupName + "VM"
$VMConfig = New-AzVMConfig -VMName $VMName -VMSize $VMSize |
Set-AzVMOperatingSystem -Windows -ComputerName $VMName -Credential $Cred -ProvisionVMAgent -EnableAutoUpdate |
Set-AzVMSourceImage -PublisherName $PublisherName -Offer $OfferName -Skus $Sku -Version $Version |
Add-AzVMNetworkInterface -Id $Interface.Id
# Create the VM
New-AzVM -ResourceGroupName $ResourceGroupName -Location $Location -VM $VMConfig
A máquina virtual é criada.
Observação
Se você receber um erro sobre o diagnóstico de inicialização, ignore-o. Uma conta de armazenamento padrão é criada para o diagnóstico de inicialização, pois a conta de armazenamento especificada para o disco da máquina virtual é uma conta de armazenamento premium.
Instalar a extensão SQL IaaS Agent
As máquinas virtuais do SQL Server suportam funcionalidades de gerenciamento automático com a Extensão SQL Server IaaS Agent. Para registrar seu SQL Server com a extensão, execute o comando New-AzSqlVM depois que a máquina virtual for criada. Especifique o tipo de licença para a sua VM do SQL Server, optando por pagamento conforme o uso (PAYG
), traga sua própria licença por meio do Benefício Híbrido do Azure (AHUB
) ou recuperação de desastres (DR
) para ativar a licença gratuita de réplica de DR. Para obter mais informações sobre licenciamento, confira Modelo de licenciamento.
Para registrar sua VM do SQL Server com a extensão do Agente de IaaS do SQL, primeiro registre sua assinatura no provedor de recursos usando Register-AzResourceProvider e, a seguir, registre sua VM do SQL Server com a extensão do Agente de IaaS do SQL usando New-AzSqlVM:
# Register the SQL IaaS Agent extension to your subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.SqlVirtualMachine
# Register SQL Server VM with the extension
New-AzSqlVM -Name $VMName -ResourceGroupName $ResourceGroupName -Location $Location `
-LicenseType $License
Há três maneiras de registrar com a extensão:
- Automaticamente para todas as VMs atuais e futuras em uma assinatura
- Manualmente para uma única VM
- Manualmente para várias VMs em massa
Parar ou remover uma máquina virtual
Caso não precise que a VM seja executada continuamente, é possível evitar encargos desnecessários interrompendo-a quando não estiver em uso. O comando a seguir interrompe a VM, mas a deixa disponível para uso futuro.
Stop-AzVM -Name $VMName -ResourceGroupName $ResourceGroupName
Também é possível excluir permanentemente todos os recursos associados à máquina virtual com o comando Remove-AzResourceGroup. Essa ação também excluirá a máquina virtual permanentemente; portanto, use esse comando com cuidado.
Script completo
Para obter um script completo do PowerShell que forneça uma experiência de ponta a ponta, confira Implantar o SQL Server na VM do Azure com o PowerShell.
Conteúdo relacionado
Depois que a máquina virtual for criada, você pode:
- Conectar-se à máquina virtual usando RDP
- Definir configurações do SQL Server no portal para sua VM, incluindo:
- Configurar a conectividade
- Conectar clientes e aplicativos à nova instância do SQL Server