Différences

Ci-dessous, les différences entre deux révisions de la page.

--- sysadmin:windows:cli:introduction_a_powershell [2023/06/21 19:04] – ↷ Nom de la page changé de sysadmin:windows:cli:powershell à sysadmin:windows:cli:introduction_a_powershell yoann
+++ sysadmin:windows:cli:introduction_a_powershell [2024/03/13 13:17] (Version actuelle) – Ajout référence yoann
@@ Ligne 36: / Ligne 36: @@
 # Ceci est un commentaire
 </code>
+Les commentaires permettent d'auto-documenter le code (scripts et fonctions) et peuvent être extraits par la commande **Get-Help**. Cet usage est présenté dans le wiki [[dev/powershell/integration_aide| intégration de l'aide]].
 ===== Généralités sur les commandes =====
@@ Ligne 63: / Ligne 65: @@
 # Rechercher les commandes ayant pour verbe get et "network" dans le substantif
 Get-Command -Verb Get -Noun *network*
+</code>
+==== Appel d'une cmdlet ====
+On peut invoquer une cmdlet via son nom, un alias ou son nom pleinement qualifié :
+<code powershell>
+# Exécution de la cmdlet via son nom usuel
+Get-Childtem
+# Exécution de la même cmdlet via un de ses alias
+ls
+# Exécution de la cmdlet via son nom pleinement qualifié (module\cmdlet)
+Microsoft.PowerShell.Management\Get-ChildItem
 </code>
@@ Ligne 227: / Ligne 243: @@
 <note>
-La stratégie de sécurité n'est pas conçue comme un mécanisme de sécurité permettant de réellement limiter les actions de l'utilisateur car toutes les commandes présentes dans le script pourront être saisies manuellement. C'est simplement une fonctionnalité visant à empêcher les exécution involontaires.
+La stratégie d'exécution n'est pas conçue comme un mécanisme de sécurité permettant de réellement limiter les actions de l'utilisateur car toutes les commandes présentes dans le script pourront être saisies manuellement. C'est simplement une fonctionnalité visant à empêcher les exécution involontaires.
 </note>
+Les stratégies d'exécutions sont les suivantes :
+  * **Restricted** : Aucun script ne peut être exécuté ;
+  * **AllSigned** : Des scripts ne peuvent être exécutés que s’ils sont signés numériquement ;
+  * **RemoteSigned** : Des scripts téléchargés ne peuvent être exécutés que s’ils sont signés numériquement ;
+  * **Unrestricted** : Tous les scripts peuvent être exécutés, mais une invite de confirmation s’affiche lors de l’exécution de scripts non signés qui sont téléchargés ;
+  * **Bypass** : Tous les scripts sont exécutés sans invite ;
+  * **Undefined** : La stratégie n'est pas définie.
 <code powershell>
@@ Ligne 240: / Ligne 265: @@
 Get-ExecutionPolicy -Scope CurrentUser
 </code>
+<note>
+Si la stratégie effective est **undefined** la stratégie d’exécution la plus restrictive est appliquée (**Restricted**).
+</note>
 La documentation officielle en ligne détaille les différentes [[https://learn.microsoft.com/fr-fr/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1|stratégies d'exécution de powershell]].
@@ Ligne 396: / Ligne 425: @@
 ===== PowerShell Gallery =====
 PowerShell Gallery est un dépôt centralisé dédié aux technologies PowerShell. A partir de Windows PowerShell 5.0 le module PowerShellGet permet de rechercher et d'installer des scripts et modules.  **Find-Command** fonctionne de façon similaire à Get-Command mais permet de rechercher dans le dépôt. Le résultat filtré pourra être envoyer a **Install-Module** pour installer localement le module souhaité.
+Les principales cmdlets pour rechercher dans PowerShell Gallery :
+^ Find-Command | |
+^ Find-Script  | |
+^ Find-Module  | |
 ===== Références =====
@@ Ligne 403: / Ligne 437: @@
   * https://learn.microsoft.com/fr-fr/powershell/scripting/learn/ps101/01-getting-started?view=powershell-5.1
   * https://www.powershellgallery.com/
+  * [[https://www.youtube.com/watch?v=UYs8Cn-qvVg|15 commandes indispensables pour débuter avec PowerShell (youtube.com) ]]

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page