Comment commencer

Voici les étapes de base à suivre pour débuter avec les appels d'API exécutés depuis une console PowerShell.

  1. Dans la console Security Controls, lancez une console Windows PowerShell.
    Veillez à spécifier Exécuter en tant qu'administrateur lors du lancement de la console PowerShell.
  2. Chargez le module d'API STProtect en exécutant la commande PowerShell suivante :

    3. PS C:\Import-Module STProtect –PassThru

    Le module d'API STProtect contient des appels d'API qui vous permettent d'interagir avec de nombreuses fonctions dans Security Controls. L'option facultative –PassThru fournit des commentaires de diagnostic sur la façon dont le module est chargé.

    Vous devez toujours commencer par charger ce module, à chaque écriture d'un script. Pour garantir que le module est toujours chargé, l'une des méthodes consiste à ajouter la commande d'importation de module à votre profil d'utilisateur PowerShell.

  3. Chargez tous les autres modules Windows ou tiers requis.
    Vous pouvez avoir besoin d'extraits de commande (commandlet) provenant d'autres modules pour interagir avec d'autres périphériques de votre environnement. Par exemple :
    • Servermanager : Nécessaire pour interagir avec le cluster SQL.
    • Failoverclusters : Charge les clusters Outils d'administration de serveur distant (RSAT) Windows.
  4. Exécutez des commandes distinctes ou des commandes scriptées.

    5. Pour consulter la liste complète des commandes disponibles, reportez-vous à « Comment afficher des informations d'aide détaillées sur les commandes PowerShell ».

    Voici quelques exemples courants :

    Exécution d'une analyse des correctifs

    Start-PatchScan –MachineGroups “Ma machine”

    Démarrage d'une analyse des correctifs et affichage des résultats

    Start-PatchScan –MachineGroups “Ma machine” | Watch-PatchScan

    Déploiement des correctifs manquants

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

  5. Lorsque vous avez fini, fermez la console Windows PowerShell.
    Tous les modules que vous avez importés ou les éléments stockés en mémoire sont effacés lorsque vous fermez la console PowerShell. Les opérations d'analyse ou de déploiement que vous avez lancées ne s'arrêtent pas lorsque vous fermez PowerShell.