Criando e gerenciando scripts

Prev Next

Introdução

O módulo Scripts no HP Workforce Experience Platform (WXP) permite implantar scripts personalizados do PowerShell 5.1 em grupos de dispositivos gerenciados. No momento, esse recurso está disponível para Windows 10 e Windows 11 e ajuda a automatizar tarefas administrativas de rotina em toda a frota de dispositivos.

         
Nota:
         

O recurso Scripts está atualmente em Beta. Alguns recursos avançados, como edição e exclusão de scripts, estão planejados em versões futuras.

Este artigo fornece um passo a passo para os seguintes tópicos:

Acessando a biblioteca de scripts

  1. Iniciar sessão no WXP A página inicial é apresentada.
  2. No menu à esquerda, clique em Correções > Scripts. A página Scripts é exibida com três guias:
    • Biblioteca (padrão): exibe todos os scripts disponíveis criados ou carregados pelos usuários.
    • Atribuições: vincula um script do PowerShell a um ou mais grupos de dispositivos para execução manual ou agendada.
    • Galeria: Exibe scripts selecionados fornecidos pela HP.
  3. Na guia Biblioteca , as seguintes colunas são exibidas:
Descrição do campo
Nome do script O nome do script.
Versão O número da versão do script.
Criado por O usuário que criou o script.
Sinopse Uma breve descrição do roteiro.
Operação Indica se o script é uma Ação ou Avaliação.

As colunas opcionais incluem:

Descrição do campo
Script ID Um identificador exclusivo atribuído a cada script.
Executar como Indica o contexto ou usuário que executará o script. As opções são Sistema ou Usuário .
Ambiente de host Especifica se o script é executado em um ambiente de 32 bits ou 64 bits.
Política de execução Determina regras de execução de script, como Ignorar ou Padrão do Cliente.

Use o ícone de engrenagem (Opções de coluna) para adicionar colunas para remover colunas da exibição padrão. Clique em Redefinir para o padrão para restaurar a exibição padrão.

Adicionando um script à biblioteca

  1. No menu esquerdo do WXP, clique em Correções > Scripts. A guia Biblioteca é exibida por padrão.
  2. Clique em Adicionar script. A caixa de diálogo Adicionar script é exibida.
  3. Na Etapa 1 de 3, forneça o seguinte:
    • Upload de arquivo .ps1: carregue o arquivo de script do PowerShell 5.1.
    • Tipo de operação: escolha Ação para acionar uma alteração ou Avaliação para avaliar sem fazer alterações.
  4. Na Etapa 2 de 3, defina as propriedades de execução:
    • Executar como: Selecione Sistema ou Usuário conectado para determinar o contexto de execução.
    • Ambiente de host: selecione 32 bits ou 64 bits para corresponder à plataforma de execução dos dispositivos de destino.
    • Política de execução: escolha Ignorar ou Padrão do cliente. Não há suporte para bypass em Todos os assinados.

Nota: Use o padrão do cliente para executar scripts assinados usando um editor confiável.

  1. Na Etapa 3 de 3, insira os metadados do script:
    • Nome do script: um nome exclusivo e descritivo para o script.
    • Versão do script: o número da versão.
    • Sinopse: Um breve resumo do que o roteiro faz.
    • Descrição: Explicação detalhada do propósito do script.
  2. Clique em Adicionar para salvar o script. Um pop-up exibe sucesso ou falha.

Nota: Os scripts devem ser atribuídos por meio da guia Atribuições . No momento, não há suporte para a edição de scripts.

Exibir detalhes do script na biblioteca

  1. No menu esquerdo do WXP, clique em Correções > Scripts > Biblioteca.
  2. Clique em um Nome de script para abrir seus detalhes. Três guias são exibidas: Visão geral (padrão), Atribuições e Atividade.

Guia Visão geral

Campos de seção
Informações do script Sinopse, descrição, criado por, data da última modificação e versão
Propriedades de execução Tipo de operação, ambiente de host, executar como, política de execução
Conteúdo do roteiro Exibe o código bruto do PowerShell.

Guia Atribuições

Descrição do campo
Estado Status atual da atribuição (por exemplo, Não agendado).
Sinopse Objetivo do roteiro neste contexto.
Operação Ação ou Avaliação.
Nome da Atribuição Nome da instância de implantação.
Grupos Grupos de dispositivos atribuídos ao script.

Guia Atividade

Descrição do campo
Iniciado em Carimbo de data/hora da execução do script.
Nome da correção Nome da instância de execução.
Operação Indica se a execução foi uma Ação ou Avaliação.
Iniciado por Usuário que acionou o script.
Estado Status atual (por exemplo, Concluído, Em andamento).

Use o ícone de engrenagem (Opções de coluna) para adicionar ou remover colunas da exibição padrão.

Filtros e classificação

  • Use a caixa de pesquisa em cada coluna para localizar scripts por Nome da correção, Operação, Iniciado por ou Status.
  • Classifique os resultados por Iniciado em.

Acessando a Galeria de Scripts

No menu esquerdo do WXP, clique em Correções > Scripts > Galeria. A guia Galeria é exibida, mostrando modelos de script selecionados pela HP. As seguintes colunas são exibidas:

Descrição do campo
Estado Indica a disponibilidade ou o status do script.
Última atualização Data da última modificação.
Nome do script Nome do script predefinido.
Versão Número da versão do script.
Criado por Autor (HP ou interno).
Tipo de operação Indica o tipo de Ação ou Avaliação.

Use o ícone de engrenagem (Opções de coluna) para adicionar ou remover colunas.

Exibindo detalhes do script na galeria

  1. No menu esquerdo do WXP, clique em Correções > Scripts > Galeria. A guia Galeria é exibida.
  2. Na guia Galeria, clique em um Nome de Script. A página de detalhes do script é exibida, mostrando os seguintes detalhes:
Campos de seção
Informações do script Sinopse, Descrição, Criado por, Última modificação, Versão
Propriedades de execução Tipo de operação, ambiente de host, arquitetura, executar como, política de execução
Conteúdo do roteiro Código-fonte completo do PowerShell
         
Nota:
         

Para usar um script do Gallery, crie uma atribuição e defina grupos de destino no fluxo de trabalho.

Acessando atribuições

No menu à esquerda do WXP, clique em Correções > Scripts > Atribuições. A guia Atribuições é exibida, mostrando os seguintes detalhes

Descrição do campo
Nome da Atribuição Nome da atribuição de script.
Script atribuído Nome do script associado.
Grupos-alvo Grupos de dispositivos atribuídos ao script.
Autor Criador da tarefa.
Estado Status atual da atribuição. Por exemplo, Agendado, Não Agendado.

As atribuições são necessárias para aplicar scripts da Biblioteca aos dispositivos.

Criando uma nova atribuição

  1. No menu à esquerda do WXP, clique em Correções > Scripts > Atribuições. A guia Atribuições é exibida.
  2. Na guia Atribuições , clique em Adicionar. A caixa de diálogo Adicionar atribuição de script é exibida, mostrando a Etapa 1 de 4 para inserir os detalhes básicos:
      • Autor: Preenchido automaticamente com o nome de usuário conectado.
      • Nome da atribuição: Insira um nome significativo para a atribuição.
      • Descrição: Explique a finalidade da implantação do script.
  3. Clique em Avançar. A etapa 2 de 4 é exibida para selecionar um script.
  4. Escolha um script na lista. Você também pode usar a barra de pesquisa para encontrar o script correto.
  5. Clique em Avançar. A etapa 3 de 4 é exibida para selecionar os grupos de destino.
  6. Use caixas de seleção para selecionar um ou mais grupos.
  7. Clique em Avançar. A etapa 4 de 4 é exibida para revisão.
  8. Revise o script selecionado e os grupos de destino.
  9. Clique em Concluir. Um pop-up é exibido indicando sucesso ou falha.

A nova atribuição pode ser exibida na guia Atribuições com um status de Não agendado.

Recursos relacionados

Para obter informações adicionais, consulte os seguintes artigos:

Contate-nos

Se você encontrar problemas, crie um caso de suporte ou envie um e-mail [email protected]para .