다음을 통해 공유

Set-ExecutionPolicy

  • 참조
모듈:
Microsoft.PowerShell.Security

Windows 컴퓨터에 대한 PowerShell 실행 정책을 설정합니다.

Syntax

Set-ExecutionPolicy
   [-ExecutionPolicy] <ExecutionPolicy>
   [[-Scope] <ExecutionPolicyScope>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

cmdlet은 Set-ExecutionPolicy Windows 컴퓨터에 대한 PowerShell 실행 정책을 변경합니다. 자세한 내용은 about_Execution_Policies를 참조하세요.

실행 정책은 PowerShell 보안 전략의 일부입니다. 실행 정책은 PowerShell 프로필과 같은 구성 파일을 로드하거나 스크립트를 실행할 수 있는지 여부를 결정합니다. 또한 스크립트를 실행하기 전에 디지털 서명해야 하는지 여부입니다.

Set-ExecutionPolicy cmdlet의 기본 scope 컴퓨터를 사용하는 모든 사용자에게 영향을 미치는 LocalMachine입니다. LocalMachine에 대한 실행 정책을 변경하려면 관리자 권한으로 실행으로 PowerShell을 시작합니다.

각 scope 대한 실행 정책을 우선 순위순으로 표시하려면 를 사용합니다Get-ExecutionPolicy -List. PowerShell 세션에 대한 유효 실행 정책을 보려면 매개 변수 없이 를 사용합니다 Get-ExecutionPolicy .

예제

예제 1: 실행 정책 설정

이 예제에서는 로컬 컴퓨터에 대 한 실행 정책을 설정 하는 방법을 보여 줍니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
Get-ExecutionPolicy -List

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

cmdlet은 Set-ExecutionPolicyExecutionPolicy 매개 변수를 사용하여 RemoteSigned 정책을 지정합니다. Scope 매개 변수는 기본 scope 값 LocalMachine을 지정합니다. 실행 정책 설정을 보려면 List 매개 변수와 Get-ExecutionPolicy 함께 cmdlet을 사용합니다.

예제 2: 그룹 정책 충돌하는 실행 정책 설정

이 명령은 LocalMachine scope 실행 정책을 제한으로 설정하려고 시도합니다. LocalMachine은 더 제한적이지만 그룹 정책 충돌하기 때문에 효과적인 정책이 아닙니다. 제한된 정책은 레지스트리 하이브 HKEY_LOCAL_MACHINE 기록됩니다.

PS> Set-ExecutionPolicy -ExecutionPolicy Restricted -Scope LocalMachine

Set-ExecutionPolicy : PowerShell updated your local preference successfully, but the setting is
overridden by the Group Policy applied to your system. Due to the override, your shell will retain
its current effective execution policy of "AllSigned". Contact your Group Policy administrator for
more information. At line:1 char:20 + Set-ExecutionPolicy <<<< restricted

PS> Get-ChildItem -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds

    Hive: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PowerShell\1\ShellIds

Name                    Property
----                    --------
Microsoft.PowerShell    Path            : C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
                        ExecutionPolicy : Restricted
ScriptedDiagnostics     ExecutionPolicy : Unrestricted

cmdlet은 Set-ExecutionPolicyExecutionPolicy 매개 변수를 사용하여 제한된 정책을 지정합니다. Scope 매개 변수는 기본 scope 값 LocalMachine을 지정합니다. cmdlet은 Get-ChildItemHKLM 공급자와 함께 Path 매개 변수를 사용하여 레지스트리 위치를 지정합니다.

예제 3: 원격 컴퓨터에서 로컬 컴퓨터에 실행 정책 적용

이 명령은 원격 컴퓨터에서 실행 정책 개체를 가져오고 로컬 컴퓨터에서 정책을 설정합니다. Get-ExecutionPolicy 는 Microsoft.PowerShell.ExecutionPolicy 개체를 파이프라인 아래로 보냅니다. Set-ExecutionPolicy 는 파이프라인 입력을 허용하며 ExecutionPolicy 매개 변수가 필요하지 않습니다.

PS> Invoke-Command -ComputerName Server01 -ScriptBlock { Get-ExecutionPolicy } | Set-ExecutionPolicy

Invoke-Command cmdlet은 로컬 컴퓨터에서 실행되고 ScriptBlock을 원격 컴퓨터로 보냅니다. ComputerName 매개 변수는 원격 컴퓨터 Server01을 지정합니다. ScriptBlock 매개 변수는 원격 컴퓨터에서 실행됩니다Get-ExecutionPolicy. 개체는 Get-ExecutionPolicy 파이프라인 Set-ExecutionPolicy아래로 로 전송됩니다. Set-ExecutionPolicy는 실행 정책을 로컬 컴퓨터의 기본 scope LocalMachine에 적용합니다.

예제 4: 실행 정책의 scope 설정

이 예제에서는 지정된 scope CurrentUser에 대한 실행 정책을 설정하는 방법을 보여 줍니다. CurrentUser scope 이 scope 설정하는 사용자에게만 영향을 줍니다.

Set-ExecutionPolicy -ExecutionPolicy AllSigned -Scope CurrentUser
Get-ExecutionPolicy -List

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

Set-ExecutionPolicy 는 ExecutionPolicy 매개 변수를 사용하여 AllSigned 정책을 지정합니다. Scope 매개 변수는 CurrentUser를 지정합니다. 실행 정책 설정을 보려면 List 매개 변수와 Get-ExecutionPolicy 함께 cmdlet을 사용합니다.

사용자에 대한 유효 실행 정책은 AllSigned가 됩니다.

예제 5: 현재 사용자에 대한 실행 정책 제거

이 예제에서는 정의되지 않은 실행 정책을 사용하여 지정된 scope 대한 실행 정책을 제거하는 방법을 보여 줍니다.

Set-ExecutionPolicy -ExecutionPolicy Undefined -Scope CurrentUser
Get-ExecutionPolicy -List

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

Set-ExecutionPolicy 는 ExecutionPolicy 매개 변수를 사용하여 정의되지 않은 정책을 지정합니다. Scope 매개 변수는 CurrentUser를 지정합니다. 실행 정책 설정을 보려면 List 매개 변수와 Get-ExecutionPolicy 함께 cmdlet을 사용합니다.

예제 6: 현재 PowerShell 세션에 대한 실행 정책 설정

프로세스 scope 현재 PowerShell 세션에만 영향을 줍니다. 실행 정책은 환경 변수 $env:PSExecutionPolicyPreference 에 저장되고 세션이 닫혀 있으면 삭제됩니다.

Set-ExecutionPolicy -ExecutionPolicy AllSigned -Scope Process

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

는 Set-ExecutionPolicyExecutionPolicy 매개 변수를 사용하여 AllSigned 정책을 지정합니다. Scope 매개 변수는 Process 값을 지정합니다. 실행 정책 설정을 보려면 List 매개 변수와 Get-ExecutionPolicy 함께 cmdlet을 사용합니다.

예제 7: 실행 정책을 변경하지 않고 스크립트를 실행하도록 차단 해제

이 예제에서는 RemoteSigned 실행 정책을 사용하여 서명되지 않은 스크립트를 실행하지 못하게 하는 방법을 보여 줍니다.

모범 사례는 cmdlet을 사용하기 Unblock-File전에 스크립트의 코드를 읽고 안전한지 확인하는 것입니다. cmdlet은 Unblock-File 스크립트를 실행할 수 있도록 차단을 해제하지만 실행 정책은 변경하지 않습니다.

PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

PS> Get-ExecutionPolicy

RemoteSigned

PS> .\Start-ActivityTracker.ps1

.\Start-ActivityTracker.ps1 : File .\Start-ActivityTracker.ps1 cannot be loaded.
The file .\Start-ActivityTracker.ps1 is not digitally signed.
The script will not execute on the system.
For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\Start-ActivityTracker.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : NotSpecified: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess

PS> Unblock-File -Path .\Start-ActivityTracker.ps1

PS> Get-ExecutionPolicy

RemoteSigned

PS> .\Start-ActivityTracker.ps1

Task 1:

는 Set-ExecutionPolicyExecutionPolicy 매개 변수를 사용하여 RemoteSigned 정책을 지정합니다. 정책은 기본 scope LocalMachine에 대해 설정됩니다.

cmdlet은 Get-ExecutionPolicyRemoteSigned 가 현재 PowerShell 세션에 대한 유효 실행 정책임을 보여 줍니다.

Start-ActivityTracker.ps1 스크립트는 현재 디렉터리에서 실행됩니다. 스크립트가 디지털 서명되지 않았기 때문에 RemoteSigned 에 의해 스크립트가 차단됩니다.

이 예제에서는 스크립트의 코드를 검토하고 실행하기에 안전한 것으로 확인되었습니다. cmdlet은 Unblock-FilePath 매개 변수를 사용하여 스크립트 차단을 해제합니다.

실행 Unblock-File 정책을 변경하지 않았는지 확인하려면 유효한 실행 정책 Get-ExecutionPolicyRemoteSigned를 표시합니다.

Start-ActivityTracker.ps1 스크립트는 현재 디렉터리에서 실행됩니다. 스크립트가 cmdlet에 의해 차단 해제되었기 때문에 실행되기 Unblock-File 시작합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExecutionPolicy

실행 정책을 지정합니다. 그룹 정책이 없고 각 scope 실행 정책이 정의되지 않음으로 설정된 경우 Restricted는 모든 사용자에게 유효한 정책이 됩니다.

허용되는 실행 정책 값은 다음과 같습니다.

  • AllSigned. 로컬 컴퓨터에 작성된 스크립트를 포함하여 신뢰할 수 있는 게시자가 모든 스크립트 및 구성 파일에 서명해야 합니다.
  • Bypass. 아무것도 차단되지 않으며 경고 또는 프롬프트가 없습니다.
  • Default입니다. 기본 실행 정책을 설정합니다. Windows 클라이언트 또는 Windows 서버용 RemoteSigned에 대해 제한됩니다.
  • RemoteSigned. 인터넷에서 다운로드한 모든 스크립트 및 구성 파일이 신뢰할 수 있는 게시자에 의해 서명되어야 합니다. Windows 서버 컴퓨터에 대한 기본 실행 정책입니다.
  • Restricted. 구성 파일을 로드하거나 스크립트를 실행하지 않습니다. 기본 실행 정책 Windows 클라이언트 컴퓨터입니다.
  • Undefined. scope 대한 실행 정책이 설정되지 않았습니다. 그룹 정책 설정되지 않은 scope 할당된 실행 정책을 제거합니다. 모든 범위의 실행 정책이 정의되지 않은 경우 유효 실행 정책은 제한됩니다.
  • Unrestricted. 모든 구성 파일을 로드하고 모든 스크립트를 실행합니다. 인터넷에서 다운로드한 서명되지 않은 스크립트를 실행할 경우 실행하기 전에 사용 권한을 묻는 메시지가 표시됩니다.
Type:ExecutionPolicy
Accepted values:AllSigned, Bypass, Default, RemoteSigned, Restricted, Undefined, Unrestricted
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

모든 확인 메시지를 표시하지 않습니다. 예기치 않은 결과를 방지하려면 이 매개 변수에 주의하세요.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

실행 정책의 영향을 받는 scope 지정합니다. 기본 scope LocalMachine입니다.

유효 실행 정책은 다음과 같이 우선 순위에 따라 결정됩니다.

  • MachinePolicy. 컴퓨터의 모든 사용자에 대해 그룹 정책 설정합니다.
  • UserPolicy. 컴퓨터의 현재 사용자에 대한 그룹 정책 의해 설정됩니다.
  • 프로세스. 현재 PowerShell 세션에만 영향을 줍니다.
  • CurrentUser. 현재 사용자에만 영향을 줍니다.
  • LocalMachine. 컴퓨터의 모든 사용자에게 영향을 주는 기본 scope.

프로세스 scope 현재 PowerShell 세션에만 영향을 줍니다. 실행 정책은 레지스트리가 아닌 환경 변수 $env:PSExecutionPolicyPreference에 저장됩니다. PowerShell 세션이 닫혀 있으면 변수와 값이 삭제됩니다.

CurrentUser scope 대한 실행 정책은 레지스트리 하이브 HKEY_LOCAL_USER 기록됩니다.

LocalMachine scope 대한 실행 정책은 레지스트리 하이브 HKEY_LOCAL_MACHINE 기록됩니다.

Type:ExecutionPolicyScope
Accepted values:CurrentUser, LocalMachine, MachinePolicy, Process, UserPolicy
Position:1
Default value:LocalMachine
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Microsoft.PowerShell.ExecutionPolicy, System.String

실행 정책 개체 또는 실행 정책 이름이 포함된 문자열을 로 파이프할 Set-ExecutionPolicy수 있습니다.

출력

None

Set-ExecutionPolicy 는 출력을 반환하지 않습니다.

참고

Set-ExecutionPolicy 는 그룹 정책에 의해 설정되므로 MachinePolicy 및 UserPolicy 범위를 변경하지 않습니다.

Set-ExecutionPolicy는 사용자 기본 설정이 정책보다 더 제한적인 경우에도 그룹 정책 재정의하지 않습니다.

컴퓨터 또는 사용자에 대해 그룹 정책 스크립트 실행 켜기를 사용하도록 설정하면 사용자 기본 설정이 저장되지만 유효하지는 않습니다. PowerShell은 충돌을 설명하는 메시지를 표시합니다.