Como Começar

Aqui estão as etapas básicas para começar a usar as chamadas de API executadas em um console do PowerShell.

1. No console do Security Controls, inicie um console do Windows PowerShell.
   Lembre-se de especificar Executar como administrador ao iniciar o console do PowerShell.
2. Carregue o módulo de API STProtect executando o seguinte comando do PowerShell:

PS C:\Import-Module STProtect –PassThru

O módulo STProtect contém chamadas de API que permitem interagir com várias áreas funcionais dentro do Security Controls. O parâmetro opcional –PassThru fornece informações de diagnóstico sobre como o módulo é carregado.

Você sempre deve carregar o módulo primeiro quando escrever um script. Uma maneira de garantir que o módulo sempre seja carregado é adicionar o comando de importação do módulo ao seu perfil de usuário do PowerShell.

3. Carregue todos os outros módulos necessários do Windows ou de terceiros.
   Você pode precisar de commandlets de outros módulos para interagir com outros dispositivos no seu ambiente. Por exemplo:
• Servermanager: necessário para interagir com o cluster SQL.
• Failoverclusters: carrega o recurso RSAT-Clustering do Windows.
4. Execute comandos individuais ou em script.

Para obter uma lista completa dos comandos disponíveis, consulte Como exibir informações detalhadas de ajuda sobre os comandos do PowerShell.

Eis alguns exemplos conhecidos:

Executar uma análise de patches

Start-PatchScan –MachineGroups “My Machine”

Iniciar e exibir resultados de uma análise de patches

Start-PatchScan –MachineGroups “Minha Máquina” | Watch-PatchScan

Implantar patches ausentes

Start-PatchDeploy –Uid 12345678-3BD2-A0ED-FFCC-9876DE8EBBAA

5. Ao terminar, feche o console do Windows PowerShell.
   Todos os módulos importados ou itens armazenados na memória serão apagados quando o console do PowerShell for fechado. As operações de análise ou implantação que você iniciou não serão interrompidas quando o PowerShell for fechado.