Criar e executar scripts do PowerShell a partir da consola do Configuration ManagerCreate and run PowerShell scripts from the Configuration Manager console

Aplica-se a: O System Center Configuration Manager (ramo atual)Applies to: System Center Configuration Manager (Current Branch)

No Configuration Manager, além de utilizar pacotes e programas para implementar scripts, pode utilizar a seguinte funcionalidade para efetuar as seguintes ações:In Configuration Manager, in addition to using packages and programs to deploy scripts, you can use the following functionality to take the following actions:

  • Importar Scripts do PowerShell para o Configuration ManagerImport PowerShell Scripts to Configuration Manager
  • Editar os scripts a partir da consola do Configuration Manager (para apenas scripts não assinados)Edit the scripts from the Configuration Manager console (for unsigned scripts only)
  • Scripts de marca como aprovado ou negado, para melhorar a segurançaMark scripts as Approved or Denied, to improve security
  • Executar scripts em coleções de computadores de cliente do Windows e no local geridos Windows PCs.Run scripts on collections of Windows client PCs, and on-premises managed Windows PCs. Não implementa scripts, em vez disso, são executados quase imediatamente nos dispositivos cliente.You don't deploy scripts, instead, they are run almost immediately on client devices.
  • Examine os resultados devolvidos pelo script na consola do Configuration Manager.Examine the results returned by the script in the Configuration Manager console.
Dica

Nesta versão do Configuration Manager, scripts são uma funcionalidade de pré-lançamento.In this version of Configuration Manager, scripts are a pre-release feature. Para ativar scripts, consulte no System Center Configuration Manager de funcionalidades de pré-lançamento.To enable scripts, see Pre-release features in System Center Configuration Manager.

Pré-requisitosPrerequisites

Para executar scripts do PowerShell, o cliente deve executar o PowerShell versão 3.0 ou posterior.To run PowerShell scripts, the client must be running PowerShell version 3.0 or later. No entanto, se um script executa contém funcionalidade de uma versão posterior do PowerShell, o cliente em que executa o script tem de executar essa versão.However, if a script you run contains functionality from a later version of PowerShell, the client on which you run the script must be running that version.

Clientes do Configuration Manager tem de executar o cliente a partir da versão 1706 ou posterior para executar scripts.Configuration Manager clients must be running the client from the 1706 release, or later in order to run scripts.

Para utilizar scripts, tem de ser um membro da função de segurança adequado do Configuration Manager.To use scripts, you must be a member of the appropriate Configuration Manager security role.

  • Para importar e criar scripts - a conta tem de ter criar permissões para SMS Scripts no administrador total função de segurança.To import, and author scripts - Your account must have Create permissions for SMS Scripts in the Full Administrator security role.
  • Para aprovar ou negar scripts - a conta tem de ter aprovar permissões para SMS Scripts no administrador total função de segurança.To approve, or deny scripts - Your account must have Approve permissions for SMS Scripts in the Full Administrator security role.
  • Para executar scripts - a conta tem de ter executar Script permissões para coleções no Gestor de definições de compatibilidade função de segurança.To run scripts - Your account must have Run Script permissions for Collections in the Compliance Settings Manager security role.

Para mais informações sobre funções de segurança do Configuration Manager, consulte Noções básicas da administração baseada em funções.For more information about Configuration Manager security roles, see Fundamentals of role-based administration.

Por predefinição, os utilizadores não podem aprovar um script que tenham criado.By default, users cannot approve a script they have authored. Uma vez scripts são poderosa, versátil e podem ser implementados em vários dispositivos, pode dividir as funções entre a pessoa que cria o script e a pessoa que aprove o script.Because scripts are powerful, versatile, and can be deployed to many devices, you can separate the roles between the person that authors the script and the person that approves the script. Estas funções dar um nível adicional de segurança contra a execução de um script sem supervisão.These roles give an additional level of security against running a script without oversight. Pode desativar esta aprovação secundária, para facilitar a testar.You can turn off this secondary approval, for ease of testing.

Permitir que os utilizadores aprovar os seus próprios scriptsAllow users to approve their own scripts

  1. Na consola do Configuration Manager, clique em Administração.In the Configuration Manager console, click Administration.
  2. Na área de trabalho Administração , expanda Configuração do Sitee clique em Sites.In the Administration workspace, expand Site Configuration, and then click Sites.
  3. Na lista de sites, selecione o site e, em seguida, no home page separador o Sites , clique em definições de hierarquia.In the list of sites, choose your site and then, on the Home tab, in the Sites group, click Hierarchy Settings.
  4. No geral separador do propriedades de definições de hierarquia diálogo caixa, desmarque a caixa de verificação não permitir autores de script aprovar os seus próprios scripts.On the General tab of the Hierarchy Settings Properties dialog box, clear the checkbox Do not allow script authors to approve their own scripts.
Importante

Como melhor prática, não deve permitir que um autor de script para aprovar os seus próprios scripts.As a best practice, you shouldn't allow a script author to approve their own scripts. Só deve ser permitido num cenário de laboratório.This should only be allowed in a lab setting. . Considere cuidadosamente o impacto potencial da alteração desta definição num ambiente de produção.Please carefully consider the potential impact of changing this setting in a production environment.

Importar e editar um scriptImport and edit a script

  1. Na consola do Configuration Manager, clique em Biblioteca de Software.In the Configuration Manager console, click Software Library.
  2. No biblioteca de Software área de trabalho, clique em Scripts.In the Software Library workspace, click Scripts.
  3. No home page separador o criar , clique em criar Script.On the Home tab, in the Create group, click Create Script.
  4. No Script página do criar Script assistente, configure as seguintes definições:On the Script page of the Create Script wizard, configure the following settings:
    • Nome do script -introduza um nome para o script.Script Name - Enter a name for the script. Embora possa criar vários scripts com o mesmo nome, utilizar nomes duplicados torna mais difícil localizar o script que terá na consola do Configuration Manager.Although you can create multiple scripts with the same name, using duplicate names makes it harder for you to find the script you need in the Configuration Manager console.
    • Idioma de script -atualmente, os scripts do PowerShell só são suportados.Script language - Currently, only PowerShell scripts are supported.
    • Importar -importar um script do PowerShell para a consola.Import - Import a PowerShell script into the console. O script é apresentado no Script campo.The script is displayed in the Script field.
    • Limpar -remove o script atual o campo de Script.Clear - Removes the current script from the Script field.
    • Script -apresenta o script atualmente importado.Script - Displays the currently imported script. Pode editar o script neste campo, conforme necessário.You can edit the script in this field as necessary.
  5. Conclua o assistente.Complete the wizard. O novo script é apresentado no Script lista com um Estado de aguardar aprovação.The new script is displayed in the Script list with a status of Waiting for approval. Antes de poder executar este script nos dispositivos cliente, terá de o aprovar.Before you can run this script on client devices, you must approve it.

Exemplos de scriptScript examples

Seguem-se alguns exemplos que ilustram scripts que pode querer utilizar com esta capacidade.Here are some examples that illustrate scripts you might want to use with this capability.

Crie uma pastaCreate a folder

Novo Item "c:\scripts"-nome de pasta do tipoNew-Item "c:\scripts" -type folder name

Criar um ficheiroCreate a file

Novo Item c:\scripts\new_file.txt-nome do tipo de ficheiroNew-Item c:\scripts\new_file.txt -type file name

Aprovar ou recusar um scriptApprove or deny a script

Antes de poder executar um script, deve ser aprovado.Before you can run a script, it must be approved. Para aprovar um script:To approve a script:

  1. Na consola do Configuration Manager, clique em Biblioteca de Software.In the Configuration Manager console, click Software Library.
  2. No biblioteca de Software área de trabalho, clique em Scripts.In the Software Library workspace, click Scripts.
  3. No Script lista, selecione o script que pretende aprovar ou recusar e, em seguida, no home page separador o Script , clique em aprovar/negação.In the Script list, choose the script you want to approve or deny and then, on the Home tab, in the Script group, click Approve/Deny.
  4. No aprovar ou negar caixa de diálogo de script, aprovar, ou negar o script e, opcionalmente, introduza um comentário sobre a sua decisão.In the Approve or deny script dialog box, Approve, or Deny the script, and optionally enter a comment about your decision. Se negar um script, não pode ser executado nos dispositivos cliente.If you deny a script, it cannot be run on client devices.
  5. Conclua o assistente.Complete the wizard. No Script lista, verá o estado de aprovação alteração de coluna consoante a ação que demorou.In the Script list, you see the Approval State column change depending on the action you took.

Executar um scriptRun a script

Depois de um script é aprovado, podem ser executada em relação a uma coleção que escolher.After a script is approved, it can be run against a collection you choose.

  1. Na consola do Configuration Manager, clique em Ativos e Compatibilidade.In the Configuration Manager console, click Assets and Compliance.
  2. Nos ativos e compatibilidade área de trabalho, clique em coleções de dispositivos.In the Assets and Compliance workspace, click Device Collections.
  3. No coleções de dispositivos lista, clique na coleção de dispositivos nos quais pretende executar o script.In the Device Collections list, click the collection of devices on which you want to run the script.
  4. No home page separador o todos os sistemas , clique em executar Script.On the Home tab, in the All Systems group, click Run Script.
  5. No Script página do executar Script assistente, escolha um script da lista.On the Script page of the Run Script wizard, choose a script from the list. Apenas aprovados scripts são apresentados.Only approved scripts are shown.
  6. Clique em seguintee, em seguida, conclua o assistente.Click Next, and then complete the wizard.
Importante

O script é dado um período de tempo de uma hora para executar.The script is given a one-hour time period in which to run. Se não é executado (por exemplo, se o computador estiver desativado) neste período de tempo, deve executá-la novamente.If it does not run (for example if the PC is turned off) in this time period, you must run it again.

Importante

O script é executado como conta de sistema ou o computador em que os clientes visados.The script is executed as the system or computer account on the targeted client(s). Esta conta tem muito limitado de acesso à rede.This account has very limited network access. Qualquer acesso à sistemas remotos e localizações pelo script têm de ser aprovisionado com isto em mente.Any access to remote systems and locations by the script must be provisioned with this in mind.

Passos seguintesNext steps

Depois de executar um script em dispositivos cliente, utilize este procedimento para monitorizar o êxito da operação.After you have run a script to client devices, use this procedure to monitor the success of the operation.

  1. Na consola do Configuration Manager, clique em monitorização.In the Configuration Manager console, click Monitoring.
  2. No monitorização área de trabalho, clique em Script estado.In the Monitoring workspace, click Script Status.
  3. No Script estado lista, poderá ver os resultados para cada script executado nos dispositivos cliente.In the Script Status list, you view the results for each script you ran on client devices. Um código de saída do script de 0 normalmente indica que o script é executado com êxito.A script exit code of 0 generally indicates that the script ran successfully.