Executar comandos da CLI do Azure em runbooks do PowerShell 7.2

Você pode executar comandos da CLI do Azure em runbooks vinculados ao ambiente de tempo de execução do PowerShell 7.2.

Observação

Os comandos da CLI do Azure versão 2.56.0 estão disponíveis como um pacote padrão no ambiente de tempo de execução do PowerShell 7.2.

Pré-requisitos

• Uma conta de Automação do Azure (em qualquer região Pública com suporte, exceto Índia Central, Alemanha Norte, Itália Norte, Israel Central, Polônia Central, Emirados Árabes Unidos Central e nuvens Governo).

Criar ambiente de tempo de execução

Observação

Em vez de criar um novo ambiente de tempo de execução do PowerShell 7.2, você pode usar o ambiente de tempo de execução do PowerShell 7.2 gerado pelo sistema.

Portal do Azure

1. Entre no portal do Azure e selecione sua conta de automação.

2. Em Automação de Processos, selecione Ambientes de Tempo de Execução (visualização) e selecione Criar.

3. Na guia Noções básicas , forneça os seguintes detalhes:

   1. Forneça Nome para o ambiente de Tempo de Execução. Ele deve começar com alfabeto e pode conter apenas alfabetos, números, sublinhados e traços.
   2. Na lista suspensa Idioma , selecione PowerShell.
   3. Na versão Runtime para linguagem de script, selecione 7.2
   4. Forneça a descrição apropriada.

4. Na guia Pacotes , na lista suspensa Versão do pacote , você verá Az versão 8.3 e Azure CLI versão 2.56.0 já presentes.

5. Selecione +Adicionar da galeria para adicionar mais pacotes da galeria e selecione Avançar.

6. Na guia Revisar + criar , revise as entradas e selecione Criar.

   Uma notificação aparece para confirmar que um ambiente de tempo de execução foi criado com êxito.

   

REST API

A CLI do Azure versão 2.56.0 está disponível apenas para o ambiente de tempo de execução do PowerShell 7.2.

PUT
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview
{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "8.3.0",
            "Azure CLI": "2.56.0"
        } 
     }, 
    "name": "<runtimeEnvironmentName>"
}

Criar Runbook

Portal do Azure

Você pode criar um novo runbook do PowerShell que ofereça suporte a comandos da CLI do Azure e esteja associado ao ambiente de tempo de execução do PowerShell 7.2.

Para criar um runbook, execute estas etapas:

Na sua conta de Automação, em Automação de Processos, selecione Runbooks.

1. Selecione Criar.

2. Na guia Noções básicas, você pode criar um novo runbook ou carregar um arquivo do computador local ou da galeria do PowerShell.

   1. Forneça um Nome para o runbook. Ele deve começar com uma letra e pode conter apenas letras, números, sublinhados e traços.

   2. Na lista suspensa Tipo de runbook, selecione o tipo de runbook que você deseja criar.

   3. Selecione Ambiente de tempo de execução do PowerShell 7.2 criado anteriormente.

   4. Forneça a descrição apropriada.

      

3. Adicione o código do runbook na página Editar runbook e selecione Salvar.

4. Executar runbook de teste no painel Teste. Depois de confirmar os resultados, selecione Publicar para publicar o runbook e executá-lo.

REST API

Você pode criar runbooks e vincular com o ambiente de tempo de execução do PowerShell 7.2.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview


{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
}

Próximas etapas

• Consulte Gerenciar ambiente de tempo de execução para exibir as várias operações por meio do portal e da API REST.