의 버전 5(V5) AWS Tools for PowerShell 가 릴리스되었습니다.
변경 사항 해제 및 애플리케이션 마이그레이션에 대한 자세한 내용은 마이그레이션 주제를 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
WindowsAWS.Tools
에 설치(권장)
사전 조건 및 기타 옵션을 포함하여 Windows AWS Tools for PowerShell 에를 설치하는 방법에 대한 일반적인 내용은 상위 주제를 참조하세요.
에 사전 설치된 Tools for PowerShell에 대한 자세한 내용은 섹션을 AWS CloudShell참조하세요CloudShell에 설치됨.
Windows PowerShell 5.1 또는 PowerShell Core 6.0 이상에서 Windows를 실행하는 AWS Tools for PowerShell 컴퓨터에 모듈화된 버전의를 설치할 수 있습니다. PowerShell Core를 설치하는 방법에 대한 자세한 내용은 Microsoft 웹 사이트에서 PowerShell의 다양한 버전 설치
다음 세 가지 방법 중 하나로 AWS.Tools
를 설치할 수 있습니다.
AWS.Tools.Installer
모듈에서 cmdlet을 사용합니다. 이 모듈은 다른AWS.Tools
모듈의 설치 및 업데이트를 간소화합니다. 에는가AWS.Tools.Installer
필요하며 업데이트된 버전을PowerShellGet
자동으로 다운로드하여 설치합니다.는 모듈 버전을AWS.Tools.Installer
자동으로 동기화된 상태로 유지합니다. 한 모듈의 최신 버전을 설치하거나 업데이트하면의 cmdlet이 다른 모든AWS.Tools
모듈을 동일한 버전으로AWS.Tools.Installer
자동으로 업데이트합니다.이 방법은 다음 절차에 설명되어 있습니다.
-
AWS.Tools.zip
에서 모듈을 다운로드하고 모듈 폴더 중 하나에 압축을 해제합니다.PSModulePath
환경 변수의 값을 표시하여 모듈 폴더를 찾을 수 있습니다.주의
ZIP 파일을 다운로드한 후 콘텐츠를 추출하기 전에 차단을 해제해야 할 수 있습니다. 이는 일반적으로 파일의 속성을 열고, 일반 탭을 보고, 있는 경우 차단 해제 확인란을 선택하여 수행됩니다.
ZIP 파일을 차단 해제해야 하지만 차단하지 않으면 “가져오기-모듈: 파일 또는 어셈블리를 로드할 수 없음”과 유사한 오류가 발생할 수 있습니다.
-
Install-Module
cmdlet을 사용하여 PowerShell Gallery에서 각 서비스 모듈을 설치합니다.
AWS.Tools.Installer
모듈을 사용하여 WindowsAWS.Tools
에를 설치하려면
-
PowerShell 세션을 시작합니다.
참고
수행해야 하는 작업에서 요구하는 경우를 제외하고 승격된 권한을 가진 관리자로 PowerShell을 실행하지 않는 것이 좋습니다. 이는 잠재적 보안 위험 때문이며 최소 권한의 원칙과 일치하지 않습니다.
-
모듈화된
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 -
이제
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/)에서 요청된 모든 모듈을 다운로드하고 신뢰할 수 있는 소스로 간주합니다. 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
에 있는 것과 같이 적절한 모듈 이름을 사용하여 유사한 명령을 실행합니다.
스크립트 실행 활성화
AWS Tools for PowerShell 모듈을 로드하려면 PowerShell 스크립트 실행을 활성화해야 합니다. 스크립트 실행을 활성화하려면 Set-ExecutionPolicy
cmdlet을 실행하여 RemoteSigned
정책을 설정합니다. 자세한 내용은 Microsoft Technet 웹 사이트의 실행 정책 소개
참고
이는 Windows를 실행하는 컴퓨터에만 적용되는 요구 사항입니다. 다른 운영 체제에는 ExecutionPolicy
보안 제한이 없습니다.
스크립트 실행을 활성화하려면
-
실행 정책을 설정하려면 관리자 권한이 필요합니다. 관리자 권한이 있는 사용자로 로그인하지 않은 경우, 관리자 권한으로 PowerShell 세션을 엽니다. 시작을 선택한 다음 All Programs(모든 프로그램)를 선택합니다. Accessories(액세서리)를 선택한 다음 Windows PowerShell을 선택합니다. Windows PowerShell을 마우스 오른쪽 버튼으로 클릭한 후 컨텍스트 메뉴에서 Run as administrator(관리자 권한으로 실행)를 선택합니다.
-
명령 프롬프트에서 다음을 입력합니다.
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
에는 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을 실행합니다.
예시:
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 명령에 -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
을 입력하여 $PSVersionTable 자동 변수
예시:
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/Get-PSRepository -Name PSGallery
명령을 사용합니다PSRepository
.