버전 5(V5) AWS Tools for PowerShell 가 릴리스되었습니다.
변경 사항 해제 및 애플리케이션 마이그레이션에 대한 자세한 내용은 [마이그레이션 주제를](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 참조하세요.
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Windows PowerShell에 AWSPowerShell 설치(레거시)
사전 조건 및 기타 옵션을 포함하여 Windows AWS Tools for PowerShell 에를 설치하는 방법에 대한 일반적인 내용은 [상위 주제를](pstools-getting-set-up-windows.md) 참조하세요.
에 사전 설치된 Tools for PowerShell에 대한 자세한 내용은 섹션을 AWS CloudShell참조하세요[CloudShell에 설치됨](pstools-getting-set-up-cloudshell.md).
**참고**
AWSPowerShell은 설치에 권장되는 방법이 아닙니다 AWS Tools for PowerShell. 권장 방법은 [설치`AWS.Tools`(권장)](ps-installing-awstools.md) 대신 단원을 참조하십시오.
다음 두 가지 방법 중 하나로 AWS Tools for Windows PowerShell 를 설치할 수 있습니다.
+ [AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip)에서 모듈을 다운로드하고 모듈 디렉터리 중 하나에 압축을 해제합니다. `PSModulePath` 환경 변수의 값을 표시하여 모듈 디렉토리를 찾을 수 있습니다.
**주의**
ZIP 파일을 다운로드한 후 콘텐츠를 추출하기 전에 차단을 해제해야 할 수 있습니다. 이는 일반적으로 파일의 속성을 열고, **일반** 탭을 확인하고, 있는 경우 **차단 해제** 확인란을 선택하여 수행됩니다.
ZIP 파일을 차단 해제해야 하지만 차단하지 않으면 ‘Import-Module : Could not load file or assembly’와 유사한 오류가 발생할 수 있습니다.
+ 다음 절차에 설명된 대로 `Install-Module` cmdlet을 사용하여 PowerShell Gallery에서 설치합니다.
**Install-Module cmdlet을 사용하여 PowerShell Gallery에서 AWSPowerShell을 설치하려면 다음을 수행합니다.**
PowerShell AWSPowerShell에서 AWSPowerShell을 설치할 수 있습니다. PowerShell [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet) 다음 명령을 실행하여 Microsoft의 [PowerShell Gallery](https://www.powershellgallery.com/packages/AWSPowerShell)에서 AWSPowerShell을 설치하고 업데이트할 수 있습니다.
```
PS > Install-Module -Name AWSPowerShell
```
AWSPowerShell 모듈을 PowerShell 세션에 자동으로 로드하려면 이전 `import-module` cmdlet을 PowerShell 프로필에 추가합니다. PowerShell 프로필 편집에 대한 자세한 내용은 PowerShell 설명서의 [프로필 소개](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6)를 참조하십시오.
## 스크립트 실행 활성화
AWS Tools for PowerShell 모듈을 로드하려면 PowerShell 스크립트 실행을 활성화해야 합니다. 스크립트 실행을 활성화하려면 `Set-ExecutionPolicy` cmdlet을 실행하여 `RemoteSigned` 정책을 설정합니다. 자세한 내용은 Microsoft Technet 웹 사이트의 [실행 정책 소개](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies)를 참조하십시오.
**참고**
이는 Windows를 실행하는 컴퓨터에만 적용되는 요구 사항입니다. 다른 운영 체제에는 `ExecutionPolicy` 보안 제한이 없습니다.
**스크립트 실행을 활성화하려면**
1. 실행 정책을 설정하려면 관리자 권한이 필요합니다. 관리자 권한이 있는 사용자로 로그인하지 않은 경우, 관리자 권한으로 PowerShell 세션을 엽니다. **시작**을 선택한 다음 **All Programs(모든 프로그램)**를 선택합니다. **Accessories(액세서리)**를 선택한 다음 **Windows PowerShell**을 선택합니다. **Windows PowerShell**을 마우스 오른쪽 버튼으로 클릭한 후 컨텍스트 메뉴에서 **Run as administrator(관리자 권한으로 실행)**를 선택합니다.
1. 명령 프롬프트에서 다음을 입력합니다.
```
PS > Set-ExecutionPolicy RemoteSigned
```
**참고**
64비트 시스템에서는 PowerShell의 32비트 버전인 **Windows PowerShell(x86)**에 대해 이 단계를 별도로 수행해야 합니다.
실행 정책이 올바르게 설정되지 않은 경우 프로필과 같은 스크립트를 실행하려고 할 때마다 PowerShell에서 다음과 같은 오류가 표시됩니다.
```
File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution
of scripts is disabled on this system. Please see "get-help about_signing" for more details.
At line:1 char:2
+ . <<<< 'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1'
+ CategoryInfo : NotSpecified: (:) [], PSSecurityException
+ FullyQualifiedErrorId : RuntimeException
```
Tools for Windows PowerShell 설치 관리자는 `AWSPowerShell` 모듈을 포함하는 디렉터리의 위치를 포함하도록 [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath)를 자동으로 업데이트합니다.
에는 AWS 모듈 디렉터리의 위치가 `PSModulePath` 포함되어 있으므로 `Get-Module -ListAvailable` cmdlet에 모듈이 표시됩니다.
```
PS > Get-Module -ListAvailable
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest AppLocker {}
Manifest BitsTransfer {}
Manifest PSDiagnostics {}
Manifest TroubleshootingPack {}
Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
```
## 버전 관리
AWS 는 새로운 AWS 서비스와 기능을 지원하기 위해의 새 버전을 AWS Tools for PowerShell 정기적으로 릴리스합니다. 현재 설치된 도구의 버전을 확인하려면 [Get-AWSPowerShellVersion cmdlet](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html)을 실행합니다.
예제:
```
PS > Get-AWSPowerShellVersion
AWS Tools for PowerShell
Version 5.0.3
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Amazon Web Services SDK for .NET
Core Runtime Version 4.0.0.13
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/changelogs/CHANGELOG.ALL.md
This software includes third party software subject to the following copyrights:
- Logging from log4net, Apache License
[http://logging.apache.org/log4net/license.html]
```
[Get-AWSPowerShellVersion](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) 명령에 `-ListServiceVersionInfo` 파라미터를 추가하여 현재 버전의 도구에서 지원되는 AWS 서비스 목록을 볼 수도 있습니다. 모듈화된 `AWS.Tools.*` 옵션을 사용하는 경우 현재 가져온 모듈만 표시됩니다.
예제:
```
PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...
Service Noun Prefix Module Name SDK
Assembly
Version
------- ----------- ----------- -----------
AWS IAM Access Analyzer IAMAA AWS.Tools.AccessAnalyzer 3.7.400.33
AWS Account ACCT AWS.Tools.Account 3.7.400.33
AWS Certificate Manager Private... PCA AWS.Tools.ACMPCA 3.7.400.34
AWS Amplify AMP AWS.Tools.Amplify 3.7.401.28
Amplify Backend AMPB AWS.Tools.AmplifyBackend 3.7.400.33
...
```
실행 중인 PowerShell 버전을 확인하려면 `$PSVersionTable`을 입력하여 \$1PSVersionTable [자동 변수](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6)의 내용을 봅니다.
예제:
```
PS > $PSVersionTable
Name Value
---- -----
PSVersion 6.2.2
PSEdition Core
GitCommitId 6.2.2
OS Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64
Platform Unix
PSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion 2.3
SerializationVersion 1.1.0.1
WSManStackVersion 3.0
```
## Windows AWS Tools for PowerShell 에서 업데이트
정기적으로의 업데이트된 버전이 AWS Tools for PowerShell 릴리스되면 로컬에서 실행 중인 버전을 업데이트해야 합니다.
### Tools for Windows PowerShell 업데이트
`Get-AWSPowerShellVersion` cmdlet을 실행하여 실행 중인 버전을 확인한 후, [PowerShell Gallery](https://www.powershellgallery.com/packages/AWSPowerShell) 웹 사이트에서 제공하는 Tools for Windows PowerShell 버전과 비교합니다. 2\$13주마다 확인하는 것이 좋습니다. 새 명령 및 AWS 서비스에 대한 지원은 해당 지원이 포함된 버전으로 업데이트한 후에만 사용할 수 있습니다.
+ `Install-Module` cmdlet을 사용하여 설치한 경우 다음 명령을 실행합니다.
```
PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell
```
+ 다운로드한 ZIP 파일을 사용하여 설치한 경우:
1. [Tools for PowerShell](https://aws.amazon.com/powershell/)에서 최신 버전을 다운로드합니다. 다운로드된 파일 이름의 패키지 버전 번호를 `Get-AWSPowerShellVersion` cmdlet을 실행할 때 얻을 수 있는 버전 번호와 비교합니다.
1. 다운로드 버전이 설치한 버전보다 번호가 높은 경우 모든 Tools for Windows PowerShell 콘솔을 닫습니다.
1. Tools for Windows PowerShell 최신 버전을 설치합니다.
설치 후 `Import-Module AWSPowerShell`를 실행하여 업데이트된 cmdlet을 PowerShell 세션에 로드합니다. 또는 **시작** 메뉴에서 사용자 지정 AWS Tools for PowerShell 콘솔을 실행합니다.