本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 自動取消註冊現場部署執行個體
<a name="on-premises-instances-operations-deregister-automatically"></a>

一般而言，不再規劃用於部署的現場部署執行個體，您會撤銷其註冊。當您註銷現場部署執行個體的註冊，即使現場部署執行個體可能為部署群組的現場部署執行個體標籤的一部分，該現場部署執行個體還是不會包含於任何部署裡。您可以使用 AWS CLI 取消註冊現場部署執行個體。

**注意**  
您無法使用 CodeDeploy 主控台取消註冊現場部署執行個體。此外，將內部部署執行個體撤銷註冊，會移除與內部部署執行個體相關聯的內部部署執行個體標籤。它不會從現場部署執行個體解除安裝 CodeDeploy 代理程式。它不會從現場部署執行個體移除現場部署執行個體的組態檔案。  
若要使用 CodeDeploy 主控台執行本節中的部分 （但不是全部） 活動，請參閱 的 CodeDeploy 主控台一節[手動取消註冊現場部署執行個體](on-premises-instances-operations-deregister-manually.md)。  
若要手動取消任何關聯現場部署執行個體標籤，請參閱 [從內部部署執行個體手動移除內部部署執行個體標籤](on-premises-instances-operations-remove-tags.md)。  
若要自動解除安裝 CodeDeploy 代理程式並從現場部署執行個體中移除組態檔案，請參閱 [自動解除安裝 CodeDeploy 代理程式，並從內部部署執行個體移除組態檔案](on-premises-instances-operations-uninstall-agent.md)。  
若要僅從現場部署執行個體手動解除安裝 CodeDeploy 代理程式，請參閱 [管理 CodeDeploy 代理程式操作](codedeploy-agent-operations.md)。

使用 AWS CLI 呼叫[取消註冊](https://docs.aws.amazon.com/cli/latest/reference/deploy/deregister.html)命令，指定：
+ 將現場部署執行個體唯一識別為 CodeDeploy 的名稱 （使用 `--instance-name`選項）。
+  或者，是否刪除與現場部署執行個體相關聯的 IAM 使用者。預設行為是刪除 IAM 使用者。如果您不想刪除內部部署執行個體關聯的 IAM 使用者，請在命令中指定 `--no-delete-iam-user` 選項。
+ 或者，向 CodeDeploy （使用 `--region`選項） 註冊現場部署執行個體 AWS 的區域。這必須是 [區域和端點](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region)中列出的其中一個支援區域 *AWS 一般參考*（例如 `us-west-2`)。如果未指定此選項，則會使用與呼叫 IAM 使用者相關聯的預設 AWS 區域。

將執行個體撤銷註冊並刪除使用者的範例：

```
aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2
```

將執行個體撤銷註冊並且不會刪除使用者的範例：

```
aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2
```

**deregister** 命令會執行以下動作：

1. 使用 CodeDeploy 取消註冊現場部署執行個體。

1. 如果指定， 會刪除與現場部署執行個體相關聯的 IAM 使用者。

一旦取消註冊現場部署執行個體，將導致以下情況：
+  主控台不會再顯示該執行個體。
+  您能立即建立具有相同名稱的其他執行個體。

如果此命令發生錯誤，會出現錯誤訊息，說明如何手動完成剩下的步驟。不然的話，則會出現成功訊息，說明如何呼叫 **uninstall** 命令。