AWS Tools for PowerShell 버전 4에서 버전 5로 마이그레이션 - AWS Tools for PowerShell (버전 5 미리 보기)
최소 PowerShell 버전값 유형컬렉션파이프라인 및 $AWSHistory보안 인증 정보 및 프로파일 확인일관된 자동 변형S3 키 파라미터 정리

AWS Tools for PowerShell 버전 5(V5)는 미리 보기 상태이므로이 콘텐츠는 변경될 수 있습니다. 변경 사항, 설치 및 마이그레이션 중단에 대한 자세한 내용은 마이그레이션 주제를 참조하세요. 릴리스된 콘텐츠는 버전 4 사용 설명서를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS Tools for PowerShell 버전 4에서 버전 5로 마이그레이션

AWS Tools for PowerShell 버전 5(V5)에 주요 변경 사항이 있어 기존 스크립트가 작동하지 않을 수 있습니다. 이 주제에서는 V5의 주요 변경 사항과 V4에서 환경 또는 코드를 마이그레이션하기 위해 수행해야 할 수 있는 작업에 대해 설명합니다. 의 기타 주목할 만한 변경 사항 AWS Tools for PowerShell과 새 버전을 설치 및 테스트하는 방법에 대한 자세한 내용은 GitHub의 다음 개발 추적기 문제를 참조하세요https://github.com/aws/aws-tools-for-powershell/issues/357.

참고

는를 AWS Tools for PowerShell 사용하므로 SDK의 V4와 관련된 AWS SDK for .NET일부 변경 사항은 Tools for PowerShell의 V5에도 영향을 미칠 수 있습니다. 의 V4에 대해 변경된 사항을 확인하려면 AWS SDK for .NET 개발자 안내서의 마이그레이션 정보를 AWS SDK for .NET참조하세요.

최소 PowerShell 버전

레거시 Windows 전용, 단일, 대규모 모듈 버전 AWS Tools for PowerShell인 AWSPowerShell의 경우 모듈의 지원되는 최소 PowerShell 버전이 5.1로 업데이트되었습니다. 이는 .NET Framework 4.7.2의 AWS SDK for .NET 새 최소 버전과 일치하기 위한 것입니다.

AWSPowerShell 모듈에 대한 자세한 내용은 섹션을 참조하세요Windows에 설치.

값 유형

에서 채택된 유형이 해당 SDK의 새로운 null 가능한 변경 사항을 사용하도록 업데이트 AWS SDK for .NET 되었습니다. 예를 들어 유형의 속성int이 로 변경되었습니다Nullable[int]. 자세한 내용은 AWS SDK for .NET 개발자 안내서의 값 유형에 대한 마이그레이션 콘텐츠를 참조하세요.

컬렉션

일부 cmdlet 출력이 빈 컬렉션 $null 대신 반환되도록 변경되었습니다. 레거시 동작으로 되돌리는 방법을 비롯한 추가 정보는 AWS SDK for .NET 개발자 안내서의 컬렉션에 대한 마이그레이션 콘텐츠를 참조하세요.

파이프라인 및 $AWSHistory

V4 AWS Tools for PowerShell 이전의 버전에서는 AWS cmdlet 호출 및 각 호출에 대해 수신된 서비스 응답의 레코드를 유지하는 라는 세션 변수가 도입$AWSHistory되었습니다. Tools for PowerShell의 V4에서이 세션 변수는 전체 서비스 응답을 반환하는 데 사용할 수 있는 -Select * 파라미터 및 인수를 위해 더 이상 사용되지 않습니다. 이 파라미터는에 설명되어 있습니다파이프라인, 출력 및 반복.

의 V5에서 AWS Tools for PowerShell$AWSHistory 변수가 제거되었습니다. 자세한 내용은 블로그 게시물 Tools AWS for PowerShell의 예정된 메이저 버전 5 공지를 참조하세요.

보안 인증 정보 및 프로파일 확인

cmdlet에 대한 자격 증명을 확인할 때 특정 환경 변수인 AWS_PROFILE, AWS_SECRET_ACCESS_KEY, 및를 사용하도록 AWS_ACCESS_KEY_ID가 업데이트 AWS Tools for PowerShell 되었습니다AWS_SESSION_TOKEN. 또한 자격 증명 및 프로필의 확인 순서가 일부 변경되었습니다. 자세한 내용은 보안 인증 정보 및 프로파일 확인 단원을 참조하십시오.

일관된 자동 변형

페이지가 매겨진 모든 cmdlet은 기본적으로 모든 데이터를 자동 반복하도록 업데이트되었습니다. Set-AWSAutoIterationMode cmdlet을 사용하여이 동작을 되돌릴 수 있습니다. 를 실행하면 v4에서 자동 반복된 Set-AWSAutoIterationMode -IterationMode v4작업은 여전히 자동 반복되지만 나머지 작업은 수동 반복으로 돌아갑니다.

S3 키 파라미터 정리

키 파라미터 Key 및를 허용하는 특정 Amazon S3 cmdlet에서 도구 KeyPrefix버전 4는 선행 공백 제거, 슬래시("/") 및 백슬래시("”) 제거, 다른 모든 백슬래시를 슬래시로 변환, 후행 공백 제거 등의 방법으로 이러한 파라미터를 정리합니다. -EnableLegacyKeyCleaning 파라미터를 지정하여이 동작으로 되돌릴 수 있습니다.

이 정보는 다음 cmdlet에 적용됩니다.