Obtient les stratégies d'exécution pour la session active.

Syntaxe

Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]

Description

L'applet de commande Get-ExecutionPolicy reçoit les stratégies d'exécution pour la session active.

Cette stratégie d'exécution est déterminée par les stratégies d'exécution que vous définissez au moyen de Set-ExecutionPolicy et par les paramètres de stratégie de groupe de la stratégie d'exécution Windows PowerShell. La valeur par défaut est « Restricted ».

Sans paramètres, Get-ExecutionPolicy obtient la stratégie d'exécution en vigueur dans la session. Vous pouvez utiliser le paramètre List pour obtenir toutes les stratégies d'exécution qui affectent la session, ou le paramètre Scope pour obtenir la stratégie d'exécution pour une portée particulière.

Pour plus d'informations, consultez about_Execution_Policies.

Paramètres

-List

Obtient toutes les valeurs de stratégie d'exécution pour la session, répertoriées par ordre de priorité. Par défaut, Get-ExecutionPolicy obtient uniquement la stratégie d'exécution en vigueur.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Scope <ExecutionPolicyScope>

Obtient la stratégie d'exécution dans la portée spécifiée. Par défaut, Get-ExecutionPolicy obtient la stratégie d'exécution en vigueur pour la session active.

Les valeurs valides sont :

-- MachinePolicy : la stratégie d'exécution définie par une stratégie de groupe pour tous les utilisateurs de l'ordinateur.

-- UserPolicy : la stratégie d'exécution définie par une stratégie de groupe pour l'utilisateur actuel de l'ordinateur.

-- Process : la stratégie d'exécution définie pour le processus Windows PowerShell actuel.

-- CurrentUser : la stratégie d'exécution définie pour l'utilisateur actuel.

-- LocalMachine : la stratégie d'exécution définie pour tous les utilisateurs de l'ordinateur.

Obligatoire ?

false

Position ?

1

Valeur par défaut

Effective execution policy

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

Microsoft.PowerShell.ExecutionPolicy

Get-ExecutionPolicy retourne un objet pour chaque stratégie d'exécution qu'il obtient.

Remarques

Vous ne pouvez pas utiliser Get-ExecutionPolicy pour obtenir les stratégies d'exécution spécifiques définies pour une portée particulière, ni pour obtenir la stratégie d'exécution définie par une stratégie de groupe. Get-ExecutionPolicy obtient seulement la stratégie d'exécution actuelle résultant de l'application de toutes les règles de priorité.

La stratégie d'exécution fait partie de la stratégie de sécurité de Windows PowerShell. Elle détermine si vous pouvez charger des fichiers de configuration (y compris votre profil Windows PowerShell) ou exécuter des scripts et identifie, le cas échéant, les scripts dont l'exécution nécessite qu'ils soient signés numériquement.

La stratégie d'exécution actuelle dépend des stratégies que vous définissez au moyen de Set-ExecutionPolicy et des stratégies de groupe « Turn on Script Execution » (Activer l'exécution de script) des ordinateurs et utilisateurs. L'ordre de priorité est Stratégie de groupe ordinateur > Stratégie de groupe utilisateur > Stratégie d'exécution processus (session) > Stratégie d'exécution utilisateur > Stratégie d'exécution ordinateur.

Pour plus d'informations sur la stratégie d'exécution Windows PowerShell, notamment les définitions des stratégies Windows PowerShell, consultez about_Execution_Policies.

Exemple 1

C:\PS>get-executionpolicy

Restricted

Description
-----------
Cette commande obtient la stratégie d'exécution actuelle de l'interpréteur de commandes.






Exemple 2

C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy

RemoteSigned

Description
-----------
Ces commandes définissent une nouvelle préférence utilisateur pour la stratégie d'exécution de l'interpréteur de commandes, puis affichent la stratégie d'exécution en vigueur. Les commandes sont séparées par un point-virgule (;). Dans cet exemple, étant donné qu'il n'y a aucun paramètre de stratégie de groupe, la préférence utilisateur constitue la stratégie en vigueur pour l'interpréteur de commandes.






Exemple 3

C:\PS>get-executionpolicy -list

        Scope  ExecutionPolicy
        -----  ---------------
MachinePolicy  Undefined
   UserPolicy  Undefined
      Process  Undefined
  CurrentUser  AllSigned
 LocalMachine  RemoteSigned

C:\PS> get-executionpolicy
AllSigned

Description
-----------
Ces commandes obtiennent toutes les stratégies d'exécution dans la session active et la stratégie d'exécution en vigueur.

La première commande obtient toutes les stratégies d'exécution qui affectent la session active. Ces stratégies sont répertoriées par ordre de priorité.

La deuxième commande obtient uniquement la stratégie d'exécution en vigueur, qui est celle définie dans la portée CurrentUser.






Voir aussi




Table des matières