Get-ExecutionPolicy

Artigo
10/30/2009

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	Diretiva de execução em vigor
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

Nenhum

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.

Consulte também

Conceitos

Set-ExecutionPolicy
Get-AuthenticodeSignature
Set-AuthenticodeSignature
about_Execution_Policies
about_Signing

Compartilhar via