Exibir código-fonte para Manipulando VM´s com scripts PowerShell

=== Versões de softwares utilizados para criação do manual ===

{| class="wikitable"
|- style="text-align:center;"
| style="border: 2px solid #6495ED;" width="180"| '''Versão'''
| style="border: 2px solid #6495ED;" width="360"| '''Aplicação'''
|-
| style="border: 2px solid #6495ED;"| 6.3.9600.16384
| style="border: 2px solid #6495ED;"| Hyper-V
|-
| style="border: 2px solid #6495ED;"| 2012 R2 Standard
| style="border: 2px solid #6495ED;"| Windows Server
|-
| style="border: 2px solid #6495ED;"| 3.0
| style="border: 2px solid #6495ED;"| Windows PowerShell
|}


=== Introdução ===
<blockquote>Este documento visa apresentar os procedimentos-padrão para manipulação de VM´s com scripts PowerShell.</blockquote>


=== Objetivo ===
Este manual tem como objetivo, se tornar uma espécie de consulta para os analistas de DevOps, assim como capacitar analistas que iniciarem na atividade de criação de scripts PowerShell em manipulação de VM´s em quaisquer ambiente.

=== Checklist para manipulação de VM´s (em ordem de execução) ===

==== Habilitar scripts PowerShell ====
Para permitir a execução de scripts PowerShell em VM´s sem restrições, a partir de um host, é necessário inserir uma linha de comando abaixo.
<center><code>Set-ExecutionPolicy Unrestricted -force</code></center>
Onde:<br \>
'''''Set-ExecutionPolicy''''' – altera a política default do PowerShell<br \>
'''''Unrestricted''''' – permite rodar todos os scripts e arquivos de configuração<br \>
'''''- force''''' – parâmetro para forçar imediatamente a alteração da política default<br \><br \>

==== Vincula a VM para o domínio ====
Para vincular a VM para um domínio de rede, a partir de um host, é necessário inserir as linhas de comando abaixo.<br \>
<syntaxhighlight lang="doscon">1 $oldName = "<nome antigo da VM>"
2 $newName = "<nome novo para a VM>"
3 $domain = "<domínio de rede>"
4 $user = "<usuário de rede, pode ser o seu usuário>"
5 $password = ConvertTo-SecureString -String "<senha de rede>" -AsPlainText -Force
6 $username = "$domain\$user"
7 $credential = New-Object System.Management.Automation.PSCredential($username,$password)
8 Rename-Computer -NewName $newName -Force
9 Add-Computer -ComputerName $oldName -DomainName $domain -Options JoinWithNewName -Credential $credential –Restart</syntaxhighlight>
Onde:<br \>
Linhas 1 a 5 – São as variáveis com valores a definir (pelo analista que irá preparar este script). Para uma melhor explicação somente para o item 5, converte uma string de texto sem formatação (no caso, a senha) em string segura, logo força o sistema a proteger a entrada do parâmetro ''–String''.<br \>
Linha 6 – Atribui os valores das variáveis <code>$domain</code> e <code>$user</code> respectivamente, para a variável <code>$username</code><br \>
Linha 7 – Cria um objeto e salva as credenciais para a variável <code>$credential</code><br \>
Linha 8 – Força a alterar o nome da VM<br \>
Linha 9 – Vincula a VM para o domínio de rede, junto com o novo nome e as credenciais, forçando o reboot.<br \><br \>

==== Criar disco virtual e atribuir o disco para a VM ====
Para vincular a VM para um domínio de rede, a partir de um host, é necessário inserir as linhas de comando abaixo.<br \>
<syntaxhighlight lang="doscon">1 New-VHD –Path "caminho\onde\salvará\arquivo\.vhdx" -SizeBytes <tamanho>
2 Add-VMHardDiskDrive -VMName <nome da VM> -Path "caminho\onde\foi\salvo\arquivo\.vhdx"
</syntaxhighlight>
Onde:<br \>
1 – Cria um disco virtual com o caminho e tamanho (em ''Mb'' ou ''Gb'') a definir (pelo analista que irá preparar este script).<br \>
2 – Adiciona o disco virtual para a VM cujo nome deve ser o que exibe no ''Hyper-V Manager'' e informa o caminho onde foi salvo o disco virtual (arquivo ''*.vhdx'').

Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:
<center><code>powershell -command ''"caminho\do\arquivo\.ps1"''</code></center><br \>

==== Configurando o disco virtual para a VM ====
Para configurar o disco virtual para VM, irá envolver 4 arquivos. Sendo 1 deles em extensão ''*.txt'' e o resto em extensão ''*.ps1''.<br \>
Vamos definir um arquivo ''*.txt'' para criar uma série de comandos para invocar a ferramenta '''''diskpart'''''. Conforme mostra os comandos abaixo.<br \>
<syntaxhighlight lang="doscon">1  select disk 1
2  online disk
3  select disk 1
4  attributes disk clear readonly
5  select disk 1
6  create partition primary
7  select volume 4
8  format fs=ntfs label="Dados" quick compress
9  select volume 4
10 assign letter=E</syntaxhighlight>
Onde:<br \>
1 – seleciona o disco 1, no caso o disco virtual, já vinculado na VM<br \>
2 – muda o estado do disco 1 para online<br \>
3 – seleciona novamente o disco 1<br \>
4 – faz com que os atributos do disco 1 sejam limpos<br \>
5 – seleciona novamente o disco 1<br \>
6 – cria uma partição de dados primária básica para o disco 1<br \>
7 – seleciona o volume 4 que, logicamente, representa o disco 1<br \>
8 – formata o volume 4 (ou disco 1) em sistema de arquivos NTFS, com nome '''''Dados''''' e compressão rápida<br \>
9 – seleciona novamente o volume 4.<br \>
10 – atrbui letra ''E'' para o volume 4<br \>

Salve o arquivo, com nome que deseja, precedido de extensão ''.txt''.<br \>

Definiremos agora um arquivo ''.ps1'' para que copie o arquivo ''.txt'', do host para a VM. Segue a linha de comando abaixo.<br \>

<center><code>copy ''<caminho\onde\salvou\arquivo\.txt>'' ''\\<caminho\onde\salvará\arquivo\.txt>''</code></center>

Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1''.

Em seguida, definiremos o arquivo .ps1 que executa o comando diskpart, segue a linha de comando abaixo. 

<center><code>diskpart /s  <caminho\do\arquivo\.txt\na\VM></code></center>
Onde:<br \>
'''''diskpart /s''''' – inicia o script de diskpart<br \>
'''''<caminho\do\arquivo\.txt\na\VM>''''' - arquivo texto que contém o script diskpart<br \>
Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1''.

Finalmente, definiremos o arquivo ''.ps1'' que contata a VM e executa o arquivo .ps1 do procedimento anterior (aquele que executa o comando diskpart) remotamente a partir do host. Segue a linha de comando abaixo.

<center><code>Invoke-Command -ComputerName <nome da VM> -FilePath ""caminho\do\arquivo\.ps1""</code></center>
Onde:<br \>
'''''Invoke-Command''''' – executa comandos remotamente.<br \>
'''''-ComputerName''''' – parâmetro que especifica a VM (cujo nome deve ser o que exibe no Hyper-V Manager) no qual o comando é executado.<br \>
'''''-FilePath''''' – executa o script armazenado no host em uma VM <br \>
Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:
<center><code>powershell -command "caminho\do\arquivo\.ps1”</code></center><br \>

==== Desligando a VM ====
Para desligar a VM, segue o comando abaixo.<br \>
<center><code>Stop-VM –Name <nome da VM> –TurnOff</code></center>
Onde:<br \>
'''''Stop-VM''''' – comando para parar uma VM.<br \>
'''''-Name''''' – parâmetro que especifica o nome da VM (cujo nome deve ser o que exibe no ''Hyper-V Manager'').<br \>
'''''-TurnOff''''' – paramêtro usado para desligar a VM.<br \>
Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:<br \>
<center><code>powershell -command "caminho\do\arquivo\.ps1”</code></center><br \>

==== Alterando tamanho da memória RAM ====
Para alterar o tamanho da memória RAM para uma VM, segue o comando abaixo.<br \>
<center><code>Set-VM -StaticMemory -Name <nome da VM> -MemoryStartupBytes <tamanho></code></center>
Onde:<br \>
'''''Set-VM''''' – modifica as propriedades de uma VM.<br \>
'''''-StaticMemory''''' – parâmetro que define como memória estática (definida manualmente) para a VM.<br \>
'''''-MemoryStartupBytes''''' – paramêtro usado para definir o tamanho da memória para uma VM (em ''Mb'' ou ''Gb'').<br \>

Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:<br \>
<center><code>powershell -command "caminho\do\arquivo\.ps1”</code></center><br \>

==== Alterando a quantidade de processadores virtuais ====
Para alterar a quantidade de processadores virtuais para uma VM, segue o comando abaixo.<br \>
<center><code>Set-VMProcessor <nome da VM> -count <quantidade></code></center>
Onde:<br \>
'''''Set-VMProcessor''''' – modifica as propriedades do processador em uma VM.<br \>
'''''-Name''''' – parâmetro que especifica o nome da VM (cujo nome deve ser o que exibe no Hyper-V Manager).<br \>
'''''-count''''' – paramêtro usado para definir a quantidade de processadores virtuais para uma VM.<br \>

Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:<br \>
<center><code>powershell -command "caminho\do\arquivo\.ps1”</code></center><br \>

==== Startando a VM ====
Para startar a VM, segue o comando abaixo.<br \>
<center><code>Start-VM –Name <nome da VM></code></center>
Onde:<br \>
'''''Start-VM''''' – comando para startar uma VM.<br \>
'''''-Name''''' – parâmetro que especifica o nome da VM (cujo nome deve ser o que exibe no Hyper-V Manager).<br \>

Salve o arquivo, com nome que deseja, precedido de extensão ''.ps1'' e basta executar pelo prompt com a opção '''''Run as Administrador''''' com a seguinte linha de comando:<br \>
<center><code>powershell -command "caminho\do\arquivo\.ps1”</code></center><br \>