버전 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`AWS.Tools`에 설치(권장)
사전 조건 및 기타 옵션을 포함하여 Windows AWS Tools for PowerShell 에를 설치하는 방법에 대한 일반적인 내용은 [상위 주제를](pstools-getting-set-up-windows.md) 참조하세요.
에 사전 설치된 Tools for PowerShell에 대한 자세한 내용은 섹션을 AWS CloudShell참조하세요[CloudShell에 설치됨](pstools-getting-set-up-cloudshell.md).
Windows PowerShell 5.1 또는 PowerShell Core 6.0 이상에서 Windows를 실행하는 AWS Tools for PowerShell 컴퓨터에 모듈화된 버전의를 설치할 수 있습니다. PowerShell Core를 설치하는 방법에 대한 자세한 내용은 Microsoft 웹 사이트에서 [PowerShell의 다양한 버전 설치](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)를 참조하십시오.
다음 세 가지 방법 중 하나로 `AWS.Tools`를 설치할 수 있습니다.
+ `AWS.Tools.Installer` 모듈에서 cmdlet을 사용합니다. 이 모듈은 다른 `AWS.Tools` 모듈의 설치 및 업데이트를 간소화합니다. `AWS.Tools.Installer`는 `PowerShellGet`의 업데이트된 버전을 요청하고 이 버전을 자동으로 다운로드하고 설치합니다. `AWS.Tools.Installer`는 자동으로 모듈 버전의 동기화를 유지합니다. 한 모듈의 최신 버전을 설치하거나 업데이트하면 `AWS.Tools.Installer`의 cmdlet은 다른 모든 `AWS.Tools` 모듈을 동일한 버전으로 자동으로 업데이트합니다.
이 방법은 다음 절차에 설명되어 있습니다.
+ `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)`에서 모듈을 다운로드하고 모듈 폴더 중 하나에 압축을 해제합니다. `PSModulePath` 환경 변수의 값을 표시하여 모듈 폴더를 찾을 수 있습니다.
**주의**
ZIP 파일을 다운로드한 후 콘텐츠를 추출하기 전에 차단을 해제해야 할 수 있습니다. 이는 일반적으로 파일의 속성을 열고, **일반** 탭을 확인하고, 있는 경우 **차단 해제** 확인란을 선택하여 수행됩니다.
ZIP 파일을 차단 해제해야 하지만 차단하지 않으면 ‘Import-Module : Could not load file or assembly’와 유사한 오류가 발생할 수 있습니다.
+ `Install-Module` cmdlet을 사용하여 PowerShell Gallery에서 각 서비스 모듈을 설치합니다.
**`AWS.Tools.Installer` 모듈을 사용하여 Windows에 `AWS.Tools`를 설치하려면**
1. PowerShell 세션을 시작합니다.
**참고**
수행해야 하는 작업에서 요구하는 경우를 제외하고 승격된 권한을 가진 관리자로 PowerShell을 *실행하지 않는* 것이 좋습니다. 이는 잠재적 보안 위험 때문이며 최소 권한의 원칙과 일치하지 않습니다.
1. 모듈화된 `AWS.Tools` 패키지를 설치하려면 다음 명령을 실행합니다.
```
PS > Install-Module -Name AWS.Tools.Installer
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure
you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): y
```
저장소를 "신뢰할 수 없음"이라는 알림을 받은 경우에도 설치를 원하는지 묻는 메시지가 표시됩니다. PowerShell에서 모듈을 설치할 수 있도록 하려면 **y**를 입력합니다. 메시지가 표시되지 않도록 하고 저장소를 신뢰하지 않은 상태에서 모듈을 설치하려면 `-Force` 파라미터로 명령을 실행할 수 있습니다.
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
1. 이제 `Install-AWSToolsModule` cmdlet을 사용하여 사용하려는 각 AWS 서비스에 모듈을 설치할 수 있습니다. 예를 들어 다음 명령은 Amazon EC2 및 Amazon S3 모듈을 설치합니다. 이 명령은 지정된 모듈이 작동하는 데 필요한 모든 종속 모듈도 설치합니다. 예를 들어 첫 번째 `AWS.Tools` 서비스 모듈을 설치하면 `AWS.Tools.Common`도 설치됩니다. 이는 모든 AWS 서비스 모듈에 필요한 공유 모듈입니다. 또한 이전 버전의 모듈을 제거하고 다른 모듈을 동일한 최신 버전으로 업데이트합니다.
```
PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
Confirm
Are you sure you want to perform this action?
Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):
Installing module AWS.Tools.Common version 4.0.0.0
Installing module AWS.Tools.EC2 version 4.0.0.0
Installing module AWS.Tools.Glacier version 4.0.0.0
Installing module AWS.Tools.S3 version 4.0.0.0
Uninstalling AWS.Tools version 3.3.618.0
Uninstalling module AWS.Tools.Glacier
Uninstalling module AWS.Tools.S3
Uninstalling module AWS.Tools.SimpleNotificationService
Uninstalling module AWS.Tools.SQS
Uninstalling module AWS.Tools.Common
```
**참고**
이 `Install-AWSToolsModule` cmdlet은 이름이 `PSRepository`인 `PSGallery`([https://www.powershellgallery.com/](https://www.powershellgallery.com/))에서 요청된 모든 모듈을 다운로드하고 신뢰할 수 있는 소스로 간주합니다. `Get-PSRepository -Name PSGallery` 명령을 사용하여 이 `PSRepository`에 대해 자세히 알아볼 수 있습니다.
이전 명령을 실행하면 기본적으로 `%USERPROFILE%\Documents\WindowsPowerShell\Modules` 폴더에 모듈이 설치됩니다. 컴퓨터의 모든 사용자에 대해 AWS Tools for PowerShell 를 설치하려면 관리자로 시작했던 PowerShell 세션에서 다음 명령을 실행해야 합니다. 예를 들어 다음 명령은 IAM 모듈을 모든 사용자가 액세스할 수 있는 `%ProgramFiles%\WindowsPowerShell\Modules` 폴더에 설치합니다.
```
PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
```
다른 모듈을 설치하려면 [PowerShell Gallery](https://www.powershellgallery.com/packages?q=aws)에 있는 것과 같이 적절한 모듈 이름을 사용하여 유사한 명령을 실행합니다.
## 스크립트 실행 활성화
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 릴리스되면 로컬에서 실행 중인 버전을 업데이트해야 합니다.
### 모듈화된 `AWS.Tools` 모듈 업데이트
`AWS.Tools` 모듈을 최신 버전으로 업그레이드하려면 다음 명령을 실행합니다.
```
PS > Update-AWSToolsModule -CleanUp
```
이 명령은 현재 설치된 모든 `AWS.Tools` 모듈을 업데이트하고 업데이트가 성공하면 이전 버전을 제거합니다.
**참고**
이 `Update-AWSToolsModule` cmdlet은 이름이 `PSRepository`인 `PSGallery`([https://www.powershellgallery.com/](https://www.powershellgallery.com/))의 모든 모듈을 다운로드하고 신뢰할 수 있는 소스로 간주합니다. 이에 대한 자세한 내용은 `Get-PSRepository -Name PSGallery` 명령을 사용합니다`PSRepository`.