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, incluindo Adicionar Script a uma Biblioteca e Visualizar Detalhes do Script na Biblioteca.
Acessando a Galeria de Scripts, incluindo a Exibição de Detalhes do Script na Galeria.
Acessando Atribuições, incluindo a Criação de uma Nova Atribuição
Acessando a biblioteca de scripts
Iniciar sessão no WXP A página inicial é apresentada.
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.
Na guia Biblioteca , as seguintes colunas são exibidas:
Campo | 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:
Campo | 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
No menu esquerdo do WXP, clique em Correções > Scripts. A guia Biblioteca é exibida por padrão.
Clique em Adicionar script. A caixa de diálogo Adicionar script é exibida.
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.
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.
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.
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.
Suporte a parâmetros em scripts
Os scripts do WXP oferecem suporte à adição de parâmetros de entrada em scripts do PowerShell. Esse recurso ajuda clientes e parceiros a criar scripts personalizáveis e reutilizáveis em todo o ambiente.
Para atribuir parâmetros a um script:
Em Scripts Overview, acesse Parameters e clique em Add Parameter.
Insira o nome, o tipo e o valor do parâmetro. Observe que:
Até cinco parâmetros são suportados.
Os tipos suportados são String, Integer, Boolean e Switch.
Clique em Save.
A visualização Scripts exibe todos os parâmetros definidos no script. Os parâmetros devem ser especificados aqui antes de criar uma atribuição. Após a criação, o assistente de atribuição exibe uma página adicional solicitando que você confirme ou substitua quaisquer valores padrão definidos para os parâmetros.
Exibir detalhes do script na biblioteca
No menu esquerdo do WXP, clique em Correções > Scripts > Biblioteca.
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
Seção | 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
Campo | 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
Campo | 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:
Campo | 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
No menu esquerdo do WXP, clique em Correções > Scripts > Galeria. A guia Galeria é exibida.
Na guia Galeria, clique em um Nome de Script. A página de detalhes do script é exibida, mostrando os seguintes detalhes:
Seção | 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
Campo | 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
No menu à esquerda do WXP, clique em Correções > Scripts > Atribuições. A guia Atribuições é exibida.
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.
Clique em Avançar. A etapa 2 de 4 é exibida para selecionar um script.
Escolha um script na lista. Você também pode usar a barra de pesquisa para encontrar o script correto.
Clique em Avançar. A etapa 3 de 4 é exibida para selecionar os grupos de destino.
Use caixas de seleção para selecionar um ou mais grupos.
Clique em Avançar. A etapa 4 de 4 é exibida para revisão.
Revise o script selecionado e os grupos de destino.
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.
Execução de uma atribuição
No menu esquerdo do WXP, clique em Remediations > Scripts > Assignments. A guia Assignments é exibida.
Na guia Assignments, clique em um Assignment Name para acessar a página Assignment Details.
Na página Assignment Details, é possível executar uma atribuição imediatamente clicando no botão Run no canto superior direito ou rolar até o final da página e clicar em Add Schedule para agendar a execução da atribuição uma única vez ou de forma recorrente.
Contate-nos
Se você encontrar problemas, crie um caso de suporte ou envie um e-mail support@wxp.hp.compara .