Obtém as diretivas de execução para a sessão atual.
Sintaxe
Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]
Descrição
O cmdlet Get-ExecutionPolicy obtém as diretivas de execução para a sessão atual.
A diretiva de execução é determinada pelas diretivas de execução que você definiu usando Set-ExecutionPolicy e as configurações de Diretiva de Grupo da diretiva de execução do Windows PowerShell. O valor padrão é "Restricted".
Sem parâmetros, o cmdlet Get-ExecutionPolicy obtém a diretiva de execução que está em vigor na sessão. Você pode usar o parâmetro List, para obter todas as diretivas de execução que afetam a sessão, ou o parâmetro Scope para obter a diretiva de execução para um escopo específico.
Para obter mais informações, consulte about_Execution_Policies.
Parâmetros
-List
Obtém todos os valores da diretiva de execução para a sessão listada em ordem de precedência. Por padrão, o cmdlet Get-ExecutionPolicy obtém apenas a diretiva de execução que está em vigor.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
False |
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Scope <ExecutionPolicyScope>
Obtém a diretiva de execução no escopo especificado. Por padrão, o cmdlet Get-ExecutionPolicy obtém a diretiva de execução que está em vigor para a sessão atual.
Os valores válidos são:
--MachinePolicy: a diretiva de execução definida por uma Diretiva de Grupo para todos os usuários do computador.
--UserPolicy: a diretiva de execução definida por uma Diretiva de Grupo para o usuário atual do computador.
-- Process: a diretiva de execução definida para o processo atual do Windows PowerShell.
-- CurrentUser: a diretiva de execução definida para o usuário atual.
-- LocalMachine: a diretiva de execução definida para todos os usuários do computador.
|
Necessário? |
false |
|
Posição? |
1 |
|
Valor padrão |
Effective execution policy |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
None Você não pode enviar a entrada para este cmdlet. |
|
Saídas |
Microsoft.PowerShell.ExecutionPolicy Get-ExecutionPolicy retorna um objeto para cada diretiva de execução obtida. |
Observações
Você não pode usar Get-ExecutionPolicy para obter diretivas de execução específicas definidas para um escopo específico ou para obter a diretiva de execução definida por uma Diretiva de Grupo. Get-ExecutionPolicy só obtém a diretiva de execução em vigor que resulta da aplicação de todas as regras de precedência.
A diretiva de execução é parte da estratégia de segurança do Windows PowerShell. Ela determina se você pode carregar arquivos de configuração (incluindo seu perfil do Windows PowerShell) e executar scripts, bem como quais scripts, se houver algum, devem possuir assinatura digital para serem executados.
A diretiva de execução em vigor é determinada pelas diretivas que você definiu usando Set-ExecutionPolicy e pelas diretivas do grupo "Ativar Execução de Script" para computadores e usuários. A ordem de precedência é Diretiva de Grupo do Computadores > Diretiva de Grupo de Usuários > Diretiva de execução de processo (sessão) > Diretiva de execução de usuário > Diretiva de execução de computador.
Para obter mais informações sobre a diretiva de execução do Windows PowerShell, incluindo definições dessas diretivas, consulte about_Execution_Policies.
Exemplo 1
C:\PS>get-executionpolicy Restricted Descrição ----------- Esse comando obtém a diretiva de execução atual para o shell.
Exemplo 2
C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy RemoteSigned Descrição ----------- Esses comandos definem uma nova preferência de usuário para a diretiva de execução do shell e, em seguida, exibem a diretiva de execução efetiva. Os comandos são separados por um ponto-e-vírgula (;). Neste exemplo, como não há uma configuração de Diretiva de Grupo, a preferência do usuário é a diretiva efetiva para o shell.
Exemplo 3
C:\PS>get-executionpolicy -list
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
C:\PS> get-executionpolicy
AllSigned
Descrição
-----------
Estes comandos obtêm todas as diretivas de execução na sessão atual e a diretiva de execução que está em vigor.
O primeiro comando obtém todas as diretivas de execução que afetam a sessão atual. As diretivas estão em ordem de precedência.
O segundo comando obtém apenas a diretiva de execução efetiva, que é aquela definida no escopo CurrentUser.
See Also