--- title: "Criando e gerenciando scripts" slug: "creating-and-managing-scripts" description: "Automate device management with HP's Scripts feature in the Workforce Experience Platform. Deploy custom PowerShell scripts for Windows 10 and 11." updated: 2026-04-07T19:29:24Z published: 2026-04-07T19:29:24Z canonical: "learn.workforceexperience.hp.com/creating-and-managing-scripts" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt > Use this file to discover all available pages before exploring further. # Criando e gerenciando scripts ## 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](/wxp/docs/creating-and-managing-scripts#accessing-script-library), incluindo Adicionar Script a uma Biblioteca e Visualizar Detalhes do Script na Biblioteca. - [Acessando a Galeria de Scripts](/wxp/docs/creating-and-managing-scripts#accessing-script-gallery), incluindo a Exibição de Detalhes do Script na Galeria. - [Acessando Atribuições](/wxp/docs/creating-and-managing-scripts#accessing-assignments), incluindo a Criação de uma Nova Atribuição ## 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: | 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 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. ### **Suporte de parâmetros em scripts** Os scripts do WXP suportam a adição de parâmetros de entrada aos scripts do PowerShell. Esta funcionalidade ajuda clientes e parceiros a criar scripts personalizáveis e reutilizáveis em todo o ambiente. Para atribuir parâmetros a um script: 1. Em **Scripts Overview**, vá a **Parameters** e clique em **Add Parameter**. 2. Introduza o nome, o tipo e o valor do parâmetro. Tenha em atenção que: - São suportados até cinco parâmetros. - Os tipos suportados são **String**, **Integer**, **Boolean** e **Switch**. 3. Clique em **Save**. A vista **Scripts** apresenta todos os parâmetros definidos no script. Os parâmetros devem ser especificados aqui antes de criar uma atribuição. Depois de criada, o assistente de atribuição apresenta uma página adicional a solicitar a confirmação ou substituição de quaisquer valores predefinidos especificados para os parâmetros. ### 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** | 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** | **DescCampo** | **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 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: | 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 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: 1. - **Autor**: Preenchido automaticamente com o nome de usuário conectado. 2. - **Nome da atribuição**: Insira um nome significativo para a atribuição. 3. - **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**. ## **Executar uma atribuição** 1. No menu do lado esquerdo do WXP, clique em **Remediations > Scripts > Assignments**. É apresentada a aba **Assignments**. 2. Na aba **Assignments**, clique num **Assignment Name** para aceder à página **Assignment Details**. 3. Na página **Assignment Details**, pode executar uma atribuição imediatamente clicando no botão **Run** no canto superior direito ou deslocar‑se até ao 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](/wxp/docs/creating-a-support-case) ou envie um e-mail `support@wxp.hp.com`para . ## Related - [Visão geral dos scripts](/overview-of-scripts.md) - [Visão geral das políticas](/overview-of-policies.md) - [Visão geral dos segredos](/overview-of-secrets.md) - [Visão geral dos grupos](/overview-of-groups.md) - [Visão geral da correção](/overview-of-remediation.md) - [Visão geral da atividade](/overview-of-activity.md)