Como o vSphere Auto Deploy funciona com o PowerCLI

Gerenciando vSphere Auto Deploy com PowerCLI Cmdlets

Você pode gerenciar vSphere Auto Deploy com cmdlets PowerCLI para criar regras que associam hosts a perfis de imagem, perfis de host, scripts personalizados e locais no destino vCenter Server. Você também pode atualizar hosts testando a conformidade com as regras e reparando problemas de conformidade.

Visão geral do processo vSphere Auto Deploy usando PowerCLI

A introdução ao vSphere Auto Deploy requer que você aprenda como o vSphere Auto Deploy funciona, instale o servidor vSphere Auto Deploy, instale o PowerCLI, escreva PowerCLI regras que provisionem hosts e ligue seus hosts para serem inicializados com o perfil de imagem que você especificar. Você pode personalizar o perfil da imagem, o perfil do host e o local do vCenter Server.

Consulte Cenário para configurar o vSphere Auto Deploy e provisionar hosts com o vSphere PowerCLI para obter um exercício passo a passo que o ajuda a configurar seu primeiro ambiente vSphere Auto Deploy.

Para provisionar os hosts em seu ambiente com vSphere Auto Deploy com êxito, você pode seguir estas etapas.

Implantar vCenter Server.
O servidor vSphere Auto Deploy está incluído.
Configure o tipo de inicialização do serviço vSphere Auto Deploy.
Consulte Preparar seu sistema para vSphere Auto Deploy.
Instale o PowerCLI, que inclui os cmdlets vSphere Auto Deploy e vSphere ESXi Image Builder.
Consulte Instalar o software de pré-requisito e configurar o vSphere ESXi Image Builder, Usando vSphere Auto Deploy cmdlets e Usando cmdlets do VMware.Image Builder.
Localize o perfil de imagem que inclui os VIBs que você deseja implantar em seus hosts.
- Normalmente, você adiciona os depósitos que contêm o software necessário à sua sessão do PowerCLI e, em seguida, seleciona um perfil de imagem de um desses depósitos.
- Para criar um perfil de imagem personalizado, use os cmdlets vSphere ESXi Image Builder para clonar um perfil de imagem existente e adicionar os VIBs personalizados ao clone. Adicione o perfil de imagem personalizado à sessão PowerCLI.
Você deverá usar vSphere ESXi Image Builder para personalização somente se precisar adicionar ou remover VIBs. Na maioria dos casos, você pode adicionar o depósito em que VMware hospeda os perfis de imagem para sua sessão do PowerCLI como uma URL.
Inicie uma sessão do PowerCLI e conecte-se ao sistema do vCenter Server no qual o vSphere Auto Deploy está registrado.
Use o cmdlet New-DeployRule PowerCLI para escrever uma regra que atribui o perfil de imagem a um host, a vários hosts especificados por um padrão ou a todos os hosts.
```
New-DeployRule -Name "testrule" -Item image-profile -AllHosts
```
Consulte Atribuir um perfil de imagem a hosts.

Observação: vSphere Auto Deploy é otimizado para provisionar hosts que têm um endereço MAC fixo para mapeamento de endereço IP no DHCP (às vezes chamado de reservas DHCP). Se você quiser usar endereços IP estáticos, deverá configurar o perfil do host para solicitar a personalização do host. Para obter mais informações, consulte a documentação vSphere Perfis de host.
Ligue os hosts que você deseja provisionar.
Configure o host que você provisionou como um host de referência para seu perfil de host.
Você pode especificar as configurações de syslog do host de referência, configurações de firewall, armazenamento, rede e assim por diante.
Configure o host que você provisionou como um host de referência para seu perfil de host.
Você pode especificar as configurações de syslog do host de referência, configurações de firewall, armazenamento, rede e assim por diante. Consulte Configurando um host de referência vSphere Auto Deploy.
Crie e exporte um perfil de host para o host de referência.
Consulte a documentação Perfis de host.
Para provisionar vários hosts com o perfil de host, use o cmdlet Copy-DeployRule para editar a regra criada anteriormente.
Você pode revisar a regra para atribuir não apenas um perfil de imagem, mas também um perfil de host, um local vCenter Server e um pacote de scripts personalizado.
```
Copy-DeployRule -DeployRule "testrule" -ReplaceItem my_host_profile_from_reference_host,my_target_cluster
               -ReplacePattern  "ipv4=192.XXX.1.10-192.XXX.1.20"
```
Em que my_host_profile_from_reference_host é o nome do perfil do host de referência e my_target_cluster é o nome do cluster de destino.
Realize as operações de teste e reparo de conformidade para remediar os hosts.
Consulte Conformidade com as regras de teste e reparo.
Verifique se os hosts que você provisionou atendem aos seguintes requisitos.
- Cada host está conectado ao sistema vCenter Server.
- Os hosts não estão no modo de manutenção.
- Os hosts não têm falhas de conformidade.
- Cada host com um perfil de host que requer a entrada do usuário tem informações de personalização de host atualizadas.
Corrija associações de host e problemas de conformidade e reinicialize hosts até que todos os hosts atendam aos requisitos.

Leia para obter uma introdução ao processo de inicialização, as diferenças entre a primeira e as inicializações subsequentes e uma visão geral do uso da personalização do host.

Usando vSphere Auto Deploy cmdlets

Os cmdlets vSphere Auto Deploy são implementados como cmdlets do Microsoft PowerShell e incluídos em PowerCLI. Os usuários dos cmdlets vSphere Auto Deploy podem aproveitar todos os recursos do PowerCLI.

Os usuários experientes do PowerShell podem usar cmdlets vSphere Auto Deploy assim como outros cmdlets do PowerShell. Se você for novo no PowerShell e no PowerCLI, as dicas a seguir podem ser úteis.

Você pode digitar cmdlets, parâmetros e valores de parâmetros no shell PowerCLI.

Obtenha ajuda para qualquer cmdlet executando Get-Helpcmdlet_name.
Lembre-se de que o PowerShell não diferencia maiúsculas de minúsculas.
Use a conclusão de tabulação para nomes de cmdlets e nomes de parâmetros.
Formate qualquer variável e saída de cmdlet usando Format-List ou Format-Table, ou suas formas abreviadas fl ou ft. Para obter mais informações, execute o cmdlet Get-Help Format-List.

Passando parâmetros por nome

Você pode passar parâmetros por nome na maioria dos casos e colocar valores de parâmetros entre aspas duplas.

 Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile

A maioria dos exemplos na documentação do vCenter Server Instalação e configuração passa parâmetros por nome.

Passando parâmetros como objetos

Você pode passar parâmetros como objetos se quiser executar scripts e automação. A passagem de parâmetros como objetos é útil com cmdlets que retornam vários objetos e com cmdlets que retornam um único objeto. Considere o exemplo a seguir.

Associe o objeto que encapsula as informações de conformidade do conjunto de regras para um host a uma variável.
```
$tr = Test-DeployRuleSetCompliance MyEsxi42
```
Visualize a propriedade itemlist do objeto para ver a diferença entre o que está no conjunto de regras e o que o host está usando no momento.
```
$tr.itemlist
```
Corrija o host para usar o conjunto de regras revisado usando o cmdlet Repair-DeployRuleSetCompliance com a variável.
```
Repair-DeployRuleSetCompliance $tr
```

O exemplo remediará o host na próxima vez que você inicializar o host.

vSphere Auto Deploy PowerCLI Visão geral do cmdlet

Especifique as regras que atribuem perfis de imagem e perfis de host aos hosts usando um conjunto de cmdlets PowerCLI incluídos em PowerCLI.

Se você for novo no PowerCLI, leia a documentação doPowerCLI e revise Usando vSphere Auto Deploy cmdlets. Você pode obter ajuda para qualquer comando no prompt do PowerShell.

Ajuda básica: Get-Help cmdlet_name
Ajuda detalhada: Get-Help cmdlet_name -Detailed

Observação: Ao executar cmdlets vSphere Auto Deploy, forneça todos os parâmetros na linha de comando ao invocar o cmdlet. Não é recomendado fornecer parâmetros no modo interativo.

Tabela 1. Cmdlets do mecanismo de regras PowerCLI
Comando	Descrição
Get-DeployCommand	Retorna uma lista de vSphere Auto Deploy cmdlets.
New-DeployRule	Cria uma nova regra com os itens e padrões especificados.
Set-DeployRule	Atualiza uma regra existente com os itens e padrões especificados. Você não pode atualizar uma regra que faz parte de um conjunto de regras.
Get-DeployRule	Recupera as regras com os nomes especificados.
Copy-DeployRule	Clona e atualiza uma regra existente.
Add-DeployRule	Adiciona uma ou mais regras ao conjunto de regras de trabalho e, por padrão, também ao conjunto de regras ativo. Use o parâmetro NoActivate para adicionar uma regra apenas ao conjunto de regras de trabalho.
Remove-DeployRule	Remove uma ou mais regras do conjunto de regras de trabalho e do conjunto de regras ativo. Execute este comando com o parâmetro -Delete para excluir completamente a regra.
Set-DeployRuleset	Define explicitamente a lista de regras no conjunto de regras de trabalho.
Get-DeployRuleset	Recupera o conjunto de regras de trabalho atual ou o conjunto de regras ativo atual.
Switch-ActiveDeployRuleset	Ativa um conjunto de regras para que quaisquer novas solicitações sejam avaliadas por meio do conjunto de regras.
Get-VMHostMatchingRules	Recupera as regras que correspondem a um padrão. Por exemplo, você pode recuperar todas as regras que se aplicam a um host ou hosts. Use esse cmdlet principalmente para depuração.
Test-DeployRulesetCompliance	Verifica se os itens associados a um host especificado estão em conformidade com o conjunto de regras ativo.
Repair-DeployRulesetCompliance	Dada a saída de Test-DeployRulesetCompliance, esse cmdlet atualiza o perfil de imagem, o perfil do host e o local de cada host no inventário vCenter Server. O cmdlet pode aplicar perfis de imagem, aplicar perfis de host ou mover hosts para pastas ou clusters pré-especificados no sistema vCenter Server.
Apply-EsxImageProfile	Associa o perfil de imagem especificado ao host especificado.
Get-VMHostImageProfile	Recupera o perfil de imagem em uso por um host especificado. Esse cmdlet é diferente do cmdlet Get-EsxImageProfile em vSphere ESXi Image Builder.
Repair-DeployImageCache	Use esse cmdlet somente se o cache de imagem vSphere Auto Deploy for excluído acidentalmente.
Get-VMHostAttributes	Recupera os atributos de um host que são usados quando o servidor vSphere Auto Deploy avalia as regras.
Get-DeployMachineIdentity	Retorna um valor de cadeia de caracteres que vSphere Auto Deploy usa para vincular logicamente um host ESXi em vCenter Server a uma máquina física.
Set-DeployMachineIdentity	Vincula logicamente um objeto de host no banco de dados vCenter Server a uma máquina física. Use esse cmdlet para adicionar hosts sem especificar regras.
Get-DeployOption	Recupera as opções de configuração global vSphere Auto Deploy. Atualmente, esse cmdlet é compatível com a opção vlan-id, que especifica a ID de VLAN padrão para a ESXi Rede de Gerenciamento de um host provisionado com vSphere Auto Deploy. vSphere Auto Deploy usará o valor somente se o host for inicializado sem um perfil de host.
Set-DeployOption	Define o valor de uma opção de configuração global. Atualmente, há suporte para a opção vlan-id para definir a ID de VLAN padrão para a rede de gerenciamento ESXi.
Add-ProxyServer	Adiciona um servidor proxy ao banco de dados vSphere Auto Deploy. Execute o comando com o parâmetro -Address para especificar o endereço IPv4 ou IPv6. O endereço pode incluir um número de porta.
List-ProxyServer	Lista os servidores proxy que estão registrados no momento com vSphere Auto Deploy.
Delete-ProxyServer	Exclui um ou mais servidores proxy da lista de servidores proxy registrados com vSphere Auto Deploy. Você pode executar o comando com o parâmetro -id da lista de servidores proxy ou com o parâmetro-Address especificando o endereço IPv4 ou IPv6 do servidor proxy que deseja excluir.
Add-ScriptBundle	Adiciona um ou mais pacotes de scripts ao servidor vSphere Auto Deploy.
Get-ScriptBundle	Recupera a lista de pacotes de scripts disponíveis no servidor vSphere Auto Deploy e os scripts que eles contêm.
Remove-ScriptBundle	Remove um pacote de scripts de vSphere Auto Deploy. Aplicável para vSphere versão 6.7 e posterior.
Get-CustomCertificate	Recupera o certificado de host personalizado carregado no AutoDeploy. Você deve executar o comando com o parâmetro -HostId [MAC_Address \| BIOS_UUID]. Na primeira vez que você adicionar certificados personalizados, não verá nenhum certificado retornado por esse cmdlet.
List-CustomCertificates	Recupera informações sobre todos os certificados de host personalizados usados pelo Auto Deploy. A lista fornece detalhes para o nome do certificado, Host ID e Associated Host Name, que reflete o nome do vCenter Server para o servidor de Implantação automática.
Add-CustomCertificate	Adiciona um certificado personalizado ao Armazenamento de Certificados do Endpoint VMware e o associa a um host ESXi. O certificado se torna ativo após a reinicialização do host. Você pode usar o cmdlet Get-CustomCertificate para recuperar a chave de certificado de host personalizada. Você pode executar o comando com o parâmetro -HostId [MAC_Address \| BIOS_UUID] para associar o certificado ao host, especificando um -Key [file:///path/to/key.key] e um -Cert [file:///path/to/cert.crt]. O uso desse cmdlet requer o privilégio AutoDeploy.Rule.Create na pasta raiz de vCenter Server.
Remove-CustomCertificate	Remove um conjunto de certificados de host personalizados da Implantação Automática. As entradas de certificado são excluídas do banco de dados e os arquivos de certificado são removidos do armazenamento de arquivos. Os hosts que já foram inicializados com um certificado personalizado devem ser reinicializados para receber um novo certificado. Você deve fornecer pelo menos um dos parâmetros -Cert ou -HostId. O uso desse cmdlet requer o privilégio AutoDeploy.Rule.Create na pasta raiz de vCenter Server.

Atribuir um perfil de imagem a hosts

Antes de provisionar um host, você deve criar regras que atribuam um perfil de imagem a cada host que você deseja provisionar usando vSphere Auto Deploy.

vSphere Auto Deploy As regras de extensibilidade impõem que os VIBs no nível CommunitySupported só podem conter arquivos de determinados locais predefinidos, como o caminho do plug-in ESXCLI, o caminho do plug-in de jumpstart e assim por diante. Se você adicionar um VIB que está em um local diferente a um perfil de imagem, será exibido um aviso. Você pode substituir o aviso usando a opção force.

Se você chamar o cmdlet New-DeployRule em um perfil de imagem que inclui VIBs no nível CommunitySupported que violam a regra, defina $DeployNoSignatureCheck = $true antes de adicionar o perfil de imagem. Com essa configuração, o sistema ignora a validação de assinatura e não realiza a verificação das regras de extensibilidade.

Observação: Os perfis de imagem que incluem VIBs no nível CommunitySupported não são compatíveis com sistemas de produção.

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Determine a localização de um depósito de software público ou defina um perfil de imagem personalizado usando vSphere ESXi Image Builder.

Execute Add-EsxSoftwareDepot para adicionar o depósito de software que contém o perfil de imagem à sessão PowerCLI.

Tipo de depósito	Cmdlet
Depósito remoto	Execute `Add-EsxSoftwareDepot depot_url`.
Arquivo ZIP	Baixe o arquivo ZIP para um caminho de arquivo local. Execute `Add-EsxSoftwareDepot C:\\}file_path\my_offline_depot.zip`.

No depósito, localize o perfil de imagem que você deseja usar executando o cmdlet Get-EsxImageProfile.
Por padrão, o depósito ESXi inclui um perfil de imagem base que inclui ferramentas VMware e tem a cadeia de caracteres standard em seu nome e um perfil de imagem base que não inclui ferramentas VMware.
Defina uma regra na qual hosts com determinados atributos, por exemplo, um intervalo de endereços IP, sejam atribuídos ao perfil de imagem.
```
New-DeployRule -Name "testrule" -Item "My Profile25" -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
Aspas duplas são necessárias se um nome contiver espaços; caso contrário, são opcionais. Especifique -AllHosts em vez de um padrão para aplicar o item a todos os hosts.
O cmdlet cria uma regra chamada testrule. A regra atribui o perfil de imagem chamado Meu Perfil25 a todos os hosts com um fornecedor da Acme ou Zven que também têm um endereço IP no intervalo especificado.
Adicione a regra ao conjunto de regras.
```
Add-DeployRule testrule
```
Por padrão, a regra é adicionada ao conjunto de regras de trabalho e ao conjunto de regras ativo. Se você usar o parâmetro NoActivate, o conjunto de regras de trabalho não se tornará o conjunto de regras ativo.

Resultados

Quando o host inicializa do iPXE, ele relata os atributos da máquina para o console do. Use o mesmo formato dos atributos ao escrever regras de implantação.

******************************************************************
* Booting through VMware AutoDeploy...
*
* Machine attributes:
* . asset=No Asset Tag
* . domain=vmware.com
* . hostname=myhost.mycompany.com
* . ipv4=XX.XX.XXX.XXX
* . mac=XX:Xa:Xb:Xc:Xx:XX
* . model=MyVendorModel
* . oemstring=Product ID: XXXXXX-XXX
* . serial=XX XX XX XX XX XX...
* . uuid=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX
* . vendor=MyVendor
******************************************************************

O que Fazer Depois

Para hosts já provisionados com vSphere Auto Deploy, realize o teste de conformidade e as operações de reparo para provisioná-los com o novo perfil de imagem. Consulte Conformidade com as regras de teste e reparo.
Ative hosts não provisionados para provisioná-los com o novo perfil de imagem.

Gravar uma regra e atribuir um perfil de host aos hosts

vSphere Auto Deploy pode atribuir um perfil de host a um ou mais hosts. O perfil do host pode incluir informações sobre configuração de armazenamento, configuração de rede ou outras características do host. Se você adicionar um host a um cluster, o perfil de host desse cluster será usado.

Em muitos casos, você atribui um host a um cluster em vez de especificar um perfil de host explicitamente. O host usa o perfil de host do cluster.

Pré-requisitos

Instale o PowerCLI e todo o software de pré-requisito. Para obter informações, consulte vCenter Server Instalação e configuração.
Exporte o perfil de host que você deseja usar.

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Usando o vSphere Client, configure um host com as configurações que você deseja usar e crie um perfil de host desse host.
Localize o nome do perfil de host executando o cmdlet Get-VMhostProfile PowerCLI, passando o host ESXi do qual você cria um perfil de host.
No prompt PowerCLI, defina uma regra na qual os perfis de host são atribuídos a hosts com determinados atributos, por exemplo, um intervalo de endereços IP.
```
New-DeployRule -Name "testrule2" -Item my_host_profile -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
O item especificado é atribuído a todos os hosts com os atributos especificados. Este exemplo especifica uma regra chamada testrule2. A regra atribui o perfil de host especificado my_host_profile a todos os hosts com um endereço IP dentro do intervalo especificado e com um fabricante de Acme ou Zven.
Adicione a regra ao conjunto de regras.
```
Add-DeployRule testrule2
```
Por padrão, o conjunto de regras de trabalho se torna o conjunto de regras ativo, e quaisquer alterações no conjunto de regras se tornam ativas quando você adiciona uma regra. Se você usar o parâmetro NoActivate, o conjunto de regras de trabalho não se tornará o conjunto de regras ativo.

O que Fazer Depois

Atribua um host já provisionado com vSphere Auto Deploy ao novo perfil de host realizando operações de teste de conformidade e reparo nesses hosts. Para obter mais informações, consulte Conformidade com as regras de teste e reparo.
Ligue hosts não provisionados para provisioná-los com o perfil de host.

Gravar uma regra e atribuir um host a uma pasta ou cluster

vSphere Auto Deploy pode atribuir um host a uma pasta ou cluster. Quando o host é inicializado, vSphere Auto Deploy o adiciona ao local especificado no vCenter Server. Os hosts atribuídos a um cluster herdam o perfil de host do cluster.

Pré-requisitos

Prepare seu sistema e instale o Auto Deploy Server. Para obter mais informações, consulte Preparar seu sistema para vSphere Auto Deploy.
Verifique se a pasta selecionada está em um centro de dados ou em um cluster. Você não pode atribuir o host a uma pasta de nível superior autônoma.

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Defina uma regra na qual hosts com determinados atributos, por exemplo, um intervalo de endereços IP, sejam atribuídos a uma pasta ou a um cluster.
```
New-DeployRule -Name testrule3 -Item "my folder"	-Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
Este exemplo passa a pasta por nome. Em vez disso, você pode passar uma pasta, um cluster ou um objeto de centro de dados recuperado com o cmdlet Get-Folder, Get-Cluster ou Get-Datacenter.
Adicione a regra ao conjunto de regras.
```
Add-DeployRule testrule3
```
Por padrão, o conjunto de regras de trabalho se torna o conjunto de regras ativo, e quaisquer alterações no conjunto de regras se tornam ativas quando você adiciona uma regra. Se você usar o parâmetro NoActivate, o conjunto de regras de trabalho não se tornará o conjunto de regras ativo.

O que Fazer Depois

Atribua um host já provisionado com vSphere Auto Deploy à nova pasta ou local de cluster realizando a operação de teste e reparo de conformidade. Consulte Conformidade com as regras de teste e reparo.
Ligue os hosts não provisionados para adicioná-los ao local vCenter Server especificado.

Configurar um sistema sem estado executando um script personalizado

Você pode usar vSphere Auto Deploy para configurar um ou mais hosts associando scripts personalizados a uma regra vSphere Auto Deploy.

Os scripts são executados em ordem alfabética após o fluxo de trabalho de inicialização ESXi inicial do host.

Pré-requisitos

Verifique se o pacote de scripts que você deseja associar a uma regra vSphere Auto Deploy está no formato .tgz, com um tamanho máximo de 10 MB e escrito na linguagem de script Python ou BusyBox ash.

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Execute o cmdlet Add-ScriptBundle para adicionar o pacote de scripts que contém os scripts necessários ao inventário vSphere Auto Deploy.
```
Add-ScriptBundle c:/temp/MyScriptBundle.tgz
```
O nome do pacote de scripts sem a extensão .tgz é o identificador de nome ou o objeto do item do pacote de scripts. Você pode atualizar um pacote de scripts existente usando o parâmetro -Update com o cmdlet Add-ScriptBundle.
(Opcional) Execute o cmdlet Get-ScriptBundle para verificar se o pacote de scripts foi adicionado ao inventário vSphere Auto Deploy.
Defina uma regra na qual hosts com determinados atributos, por exemplo, um intervalo de endereços IP, sejam atribuídos ao pacote de scripts.
```
New-DeployRule -Name "testrule4" -Item "MyScriptBundle" -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
Aspas duplas são necessárias se um nome contiver espaços; caso contrário, são opcionais. Especifique -AllHosts em vez de um padrão para aplicar o item a todos os hosts.
Você cria uma regra chamada testrule4. A regra atribui o pacote de scripts chamado Meu Pacote de Scripts a todos os hosts com um fornecedor da Acme ou Zven que também têm um endereço IP no intervalo especificado. Você pode usar o identificador de nome do pacote de scripts ou o objeto retornado pelo cmdlet Get-ScriptBundle para identificar o pacote de scripts que deseja associar à regra.
Adicione a regra ao conjunto de regras.
```
Add-DeployRule testrule4
```
Por padrão, a regra é adicionada ao conjunto de regras de trabalho e ao conjunto de regras ativo. Se você usar o parâmetro NoActivate, o conjunto de regras de trabalho não se tornará o conjunto de regras ativo.

O que Fazer Depois

Para hosts já provisionados com vSphere Auto Deploy, realize o teste de conformidade e as operações de reparo para provisioná-los com os novos scripts. Consulte Conformidade com as regras de teste e reparo.
Ative hosts não provisionados para provisioná-los com os novos scripts.

Conformidade com as regras de teste e reparo

Quando você adiciona uma regra ao conjunto de regras vSphere Auto Deploy ou modifica uma ou mais regras, os hosts não são atualizados automaticamente. vSphere Auto Deploy aplica as novas regras somente quando você testa a conformidade com as regras e realiza a correção.

Pré-requisitos

Prepare seu sistema e instale o Auto Deploy Server. Para obter mais informações, consulte Preparar seu sistema para vSphere Auto Deploy.
Verifique se sua infraestrutura inclui um ou mais hosts ESXi provisionados com vSphere Auto Deploy e se o host no qual você instalou PowerCLI pode acessar esses hosts ESXi.

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Use PowerCLI para verificar quais regras vSphere Auto Deploy estão disponíveis no momento.
```
Get-DeployRule
```
O sistema retorna as regras e os itens e padrões associados.
Modifique uma das regras disponíveis.
Por exemplo, você pode alterar o perfil da imagem e o nome da regra.
```
Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile 
			 
```
Você não pode editar uma regra já adicionada ao conjunto de regras ativo. Em vez disso, você pode copiar a regra e substituir o item ou padrão que deseja alterar.
Verifique se você pode acessar o host para o qual deseja testar a conformidade do conjunto de regras.
```
Get-VMHost -Name MyEsxi42
```
Execute o cmdlet que testa a conformidade do conjunto de regras para o host e associe o valor de retorno a uma variável para uso posterior.
```
$tr = Test-DeployRuleSetCompliance MyEsxi42
```
Examine as diferenças entre o conteúdo do conjunto de regras e a configuração do host.
```
$tr.itemlist
```
Se o host para o qual você deseja testar a conformidade do novo conjunto de regras estiver em conformidade com o conjunto de regras ativo, o sistema retornará uma tabela de itens atuais e esperados.
```
CurrentItem                             ExpectedItem
-----------                             ------------   
My Profile 25                           MyNewProfile
```
Corrija o host para usar o conjunto de regras revisado na próxima vez que você inicializar o host.
```
Repair-DeployRuleSetCompliance $tr
```

O que Fazer Depois

Se a regra que você alterou especificar o local do inventário, a alteração entrará em vigor quando você reparar a conformidade. Para todas as outras alterações, reinicialize seu host para que vSphere Auto Deploy aplique a nova regra e para obter a conformidade entre o conjunto de regras e o host.

Registrar um endereço de servidor Caching Proxy com vSphere Auto Deploy

A inicialização simultânea de um grande número de hosts sem estado coloca uma carga significativa no servidor vSphere Auto Deploy. Você pode balancear a carga das solicitações entre o servidor vSphere Auto Deploy e um ou mais servidores proxy que você registra com vSphere Auto Deploy.

Pré-requisitos

Procedimento

Em uma sessão do PowerCLI, execute o cmdlet Connect-VIServer para se conectar ao sistema vCenter Server com o qual vSphere Auto Deploy está registrado.
```
Connect-VIServer ipv4_or_ipv6_address
```
O cmdlet pode retornar um aviso de certificado do servidor. Em um ambiente de produção, certifique-se de que nenhum aviso de certificado do servidor resulte. Em um ambiente de desenvolvimento, você pode ignorar o aviso.
Registre um endereço de servidor proxy de armazenamento em cache com vSphere Auto Deploy executando o cmdlet Add-ProxyServer.
```
Add-ProxyServer -Address 'https://proxy_server_ip_address:port_number'
```
Você pode executar o cmdlet várias vezes para registrar vários servidores proxy. O endereço pode conter um número de porta.
(Opcional) Execute o cmdlet List-ProxyServer para verificar se o servidor proxy de armazenamento em cache está registrado com vSphere Auto Deploy.