第 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)
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Tools for PowerShell V5 的 Amazon ECR 範例
下列程式碼範例示範如何使用 AWS Tools for PowerShell V5 搭配 Amazon ECR 來執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `Get-ECRLoginCommand`
以下程式碼範例顯示如何使用 `Get-ECRLoginCommand`。
**Tools for PowerShell V5**
**範例 1：傳回一個包含登入資訊的 PSObject，該登入資訊可用於對您的 IAM 主體有權存取的任何 Amazon ECR 註冊表，進行身分驗證。讓呼叫取得授權字符所需的憑證和區域端點，是從 shell 預設值 (由 `Set-AWSCredential/Set-DefaultAWSRegion` 或 `Initialize-AWSDefaultConfiguration` Cmdlet 設定) 取得。您可以搭配 Invoke-Expression 使用 Command 屬性，登入指定的登錄檔，或在需要登入的其他工具中使用傳回的憑證。**
```
Get-ECRLoginCommand
```
**輸出：**
```
Username : AWS
Password : eyJwYXlsb2Fk...kRBVEFfS0VZIn0=
ProxyEndpoint : https://123456789012.dkr.ecr.us-west-2.amazonaws.com
Endpoint : https://123456789012.dkr.ecr.us-west-2.amazonaws.com
ExpiresAt : 9/26/2017 6:08:23 AM
Command : docker login --username AWS --password eyJwYXlsb2Fk...kRBVEFfS0VZIn0= https://123456789012.dkr.ecr.us-west-2.amazonaws.com
```
**範例 2：擷取 PSObject，其中包含用來做為 docker 登入命令輸入的登入資訊。只要 IAM 主體可以存取該登錄檔，您就可以指定要驗證的任何 Amazon ECR 登錄檔 URI。**
```
(Get-ECRLoginCommand).Password | docker login --username AWS --password-stdin 012345678910.dkr.ecr.us-east-1.amazonaws.com
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [Get-ECRLoginCommand](https://docs.aws.amazon.com/powershell/v5/reference)。