本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 的 Amazon WorkMail 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Amazon WorkMail 執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `associate-delegate-to-resource`
以下程式碼範例顯示如何使用 `associate-delegate-to-resource`。
**AWS CLI**
**將委派新增至資源**
下列 `associate-delegate-to-resource` 命令會將委派新增至資源。
```
aws workmail associate-delegate-to-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-68bf2d3b1c0244aab7264c24b9217443 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [AssociateDelegateToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/associate-delegate-to-resource.html)。
### `associate-member-to-group`
以下程式碼範例顯示如何使用 `associate-member-to-group`。
**AWS CLI**
**將成員新增至群組**
下列 `associate-member-to-group` 命令會將指定的成員新增至群組。
```
aws workmail associate-member-to-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--member-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [AssociateMemberToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/associate-member-to-group.html)。
### `create-alias`
以下程式碼範例顯示如何使用 `create-alias`。
**AWS CLI**
**建立別名**
下列 `create-alias` 命令會為指定的實體 (使用者或群組) 建立別名。
```
aws workmail create-alias \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--alias exampleAlias@site.awsapps.com
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-alias.html)。
### `create-group`
以下程式碼範例顯示如何使用 `create-group`。
**AWS CLI**
**建立新群組**
下列 `create-group` 命令會為指定的組織建立新的群組。
```
aws workmail create-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleGroup1
```
輸出：
```
{
"GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-group.html)。
### `create-resource`
以下程式碼範例顯示如何使用 `create-resource`。
**AWS CLI**
**建立新資源**
下列 `create-resource` 命令會為指定的組織建立新的資源 (會議室)。
```
aws workmail create-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleRoom1 \
--type ROOM
```
輸出：
```
{
"ResourceId": "r-7afe0efbade843a58cdc10251fce992c"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-resource.html)。
### `create-user`
以下程式碼範例顯示如何使用 `create-user`。
**AWS CLI**
**建立新的使用者**
下列 `create-user` 命令會建立新的使用者。
```
aws workmail create-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleName \
--display-name exampleDisplayName \
--password examplePa$$w0rd
```
輸出：
```
{
"UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-user.html)。
### `delete-access-control-rule`
以下程式碼範例顯示如何使用 `delete-access-control-rule`。
**AWS CLI**
**刪除存取控制規則**
下列 `delete-access-control-rule` 範例會將指定的存取控制規則從指定的 Amazon WorkMail 組織中刪除。
```
aws workmail delete-access-control-rule \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--name "myRule"
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[使用存取控制規則](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteAccessControlRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-access-control-rule.html)。
### `delete-alias`
以下程式碼範例顯示如何使用 `delete-alias`。
**AWS CLI**
**刪除別名**
下列 `delete-alias` 命令會刪除指定實體 (使用者或群組) 的別名。
```
aws workmail delete-alias \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--alias exampleAlias@site.awsapps.com
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-alias.html)。
### `delete-group`
以下程式碼範例顯示如何使用 `delete-group`。
**AWS CLI**
**刪除現有群組**
下列 `delete-group` 命令會將現有資源從 Amazon WorkMail 中刪除。
```
aws workmail delete-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱**《AWS CLI 命令參考》中的 [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-group.html)。
### `delete-mailbox-permissions`
以下程式碼範例顯示如何使用 `delete-mailbox-permissions`。
**AWS CLI**
**刪除信箱許可**
下列 `delete-mailbox-permissions` 命令會刪除先前授予使用者或群組的信箱許可。實體代表擁有信箱的使用者，承授者代表要刪除其許可的使用者或群組。
```
aws workmail delete-mailbox-permissions \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--grantee-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-mailbox-permissions.html)。
### `delete-resource`
以下程式碼範例顯示如何使用 `delete-resource`。
**AWS CLI**
**刪除現有資源**
下列 `delete-resource` 命令會將現有資源從 Amazon WorkMail 中刪除。
```
aws workmail delete-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-resource.html)。
### `delete-user`
以下程式碼範例顯示如何使用 `delete-user`。
**AWS CLI**
**若要刪除使用者**
下列 `delete-user` 命令會將指定的使用者從 Amazon WorkMail 和所有後續系統中刪除。
```
aws workmail delete-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-user.html)。
### `deregister-from-work-mail`
以下程式碼範例顯示如何使用 `deregister-from-work-mail`。
**AWS CLI**
**停用現有實體**
下列 `deregister-from-work-mail` 命令會使現有實體 (使用者、群組或資源) 無法使用 Amazon WorkMail。
```
aws workmail deregister-from-work-mail \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeregisterFromWorkMail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/deregister-from-work-mail.html)。
### `describe-group`
以下程式碼範例顯示如何使用 `describe-group`。
**AWS CLI**
**擷取群組的資訊**
下列 `describe-group` 命令會傳回指定群組的相關資訊。
```
aws workmail describe-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
輸出：
```
{
"GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"Name": "exampleGroup1",
"State": "ENABLED"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-group.html)。
### `describe-organization`
以下程式碼範例顯示如何使用 `describe-organization`。
**AWS CLI**
**擷取組織的資訊**
下列 `describe-organization` 命令會擷取指定 Amazon WorkMail 組織的資訊。
```
aws workmail describe-organization \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
輸出：
```
{
"OrganizationId": "m-d281d0a2fd824be5b6cd3d3ce909fd27",
"Alias": "alias",
"State": "Active",
"DirectoryId": "d-926726012c",
"DirectoryType": "VpcDirectory",
"DefaultMailDomain": "site.awsapps.com",
"CompletedDate": 1522693605.468,
"ARN": "arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza"
}
```
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[使用組織](https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-organization.html)。
### `describe-resource`
以下程式碼範例顯示如何使用 `describe-resource`。
**AWS CLI**
**擷取資源的資訊**
下列 `describe-resource` 命令會擷取指定資源的相關資訊。
```
aws workmail describe-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c
```
輸出：
```
{
"ResourceId": "r-7afe0efbade843a58cdc10251fce992c",
"Name": "exampleRoom1",
"Type": "ROOM",
"BookingOptions": {
"AutoAcceptRequests": true,
"AutoDeclineRecurringRequests": false,
"AutoDeclineConflictingRequests": true
},
"State": "ENABLED"
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-resource.html)。
### `describe-user`
以下程式碼範例顯示如何使用 `describe-user`。
**AWS CLI**
**擷取使用者資訊**
下列 `describe-user` 命令會擷取指定使用者的相關資訊。
```
aws workmail describe-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
輸出：
```
{
"UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Name": "exampleUser1",
"Email": "exampleUser1@site.awsapps.com",
"DisplayName": "",
"State": "ENABLED",
"UserRole": "USER",
"EnabledDate": 1532459261.827
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-user.html)。
### `disassociate-delegate-from-resource`
以下程式碼範例顯示如何使用 `disassociate-delegate-from-resource`。
**AWS CLI**
**將標籤從資源中移除**
下列 `disassociate-delegate-from-resource` 命令會將指定的成員從資源中移除。
```
ws workmail disassociate-delegate-from-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-68bf2d3b1c0244aab7264c24b9217443 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DisassociateDelegateFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/disassociate-delegate-from-resource.html)。
### `disassociate-member-from-group`
以下程式碼範例顯示如何使用 `disassociate-member-from-group`。
**AWS CLI**
**將成員從群組中移除**
下列 `disassociate-member-from-group` 命令會將指定的成員從群組中移除。
```
aws workmail disassociate-member-from-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--member-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DisassociateMemberFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/disassociate-member-from-group.html)。
### `get-access-control-effect`
以下程式碼範例顯示如何使用 `get-access-control-effect`。
**AWS CLI**
**取得存取控制規則的效果**
下列 `get-access-control-effect` 範例會擷取指定 IP 位址、存取通訊協定動作和使用者 ID 其指定 Amazon WorkMail 組織的存取控制規則效果。
```
aws workmail get-access-control-effect \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--ip-address "192.0.2.0" \
--action "WindowsOutlook" \
--user-id "S-1-1-11-1111111111-2222222222-3333333333-3333"
```
輸出：
```
{
"Effect": "DENY",
"MatchedRules": [
"myRule"
]
}
```
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[使用存取控制規則](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetAccessControlEffect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/get-access-control-effect.html)。
### `get-mailbox-details`
以下程式碼範例顯示如何使用 `get-mailbox-details`。
**AWS CLI**
**取得使用者的信箱詳細資訊**
下列 `get-mailbox-details` 命令會擷取指定使用者信箱的詳細資訊。
```
aws workmail get-mailbox-details \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
輸出：
```
{
"MailboxQuota": 51200,
"MailboxSize": 0.03890800476074219
}
```
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[管理使用者帳戶](https://docs.aws.amazon.com/workmail/latest/adminguide/manage-users.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetMailboxDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/get-mailbox-details.html)。
### `list-access-control-rules`
以下程式碼範例顯示如何使用 `list-access-control-rules`。
**AWS CLI**
**列出存取控制規則**
下列 `list-access-control-rules` 範例會列出指定 Amazon WorkMail 組織的存取控制規則。
```
aws workmail list-access-control-rules \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza
```
輸出：
```
{
"Rules": [
{
"Name": "default",
"Effect": "ALLOW",
"Description": "Default WorkMail Rule",
"DateCreated": 0.0,
"DateModified": 0.0
},
{
"Name": "myRule",
"Effect": "DENY",
"Description": "my rule",
"UserIds": [
"S-1-1-11-1111111111-2222222222-3333333333-3333"
],
"DateCreated": 1581635628.0,
"DateModified": 1581635628.0
}
]
}
```
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[使用存取控制規則](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListAccessControlRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-access-control-rules.html)。
### `list-aliases`
以下程式碼範例顯示如何使用 `list-aliases`。
**AWS CLI**
**列出成員的別名**
下列 `list-aliases` 命令會列出指定成員 (使用者或群組) 的別名。
```
aws workmail list-aliases \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
輸出：
```
{
"Aliases": [
"exampleAlias@site.awsapps.com",
"exampleAlias1@site.awsapps.com"
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-aliases.html)。
### `list-group-members`
以下程式碼範例顯示如何使用 `list-group-members`。
**AWS CLI**
**列出群組成員**
下列 `list-group-members` 命令會列出指定群組的成員。
```
aws workmail list-group-members \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
輸出：
```
{
"Members": [
{
"Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Name": "exampleUser1",
"Type": "USER",
"State": "ENABLED",
"EnabledDate": 1532459261.827
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListGroupMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-group-members.html)。
### `list-groups`
以下程式碼範例顯示如何使用 `list-groups`。
**AWS CLI**
**擷取群組清單**
下列 `list-groups` 命令會擷取指定組織中群組的摘要。
```
aws workmail list-groups \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
輸出：
```
{
"Groups": [
{
"Id": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"Name": "exampleGroup1",
"State": "DISABLED"
},
{
"Id": "S-4-4-44-1122222222-2222233333-3333334444-4444",
"Name": "exampleGroup2",
"State": "ENABLED"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-groups.html)。
### `list-mailbox-permissions`
以下程式碼範例顯示如何使用 `list-mailbox-permissions`。
**AWS CLI**
**擷取信箱許可**
下列 `list-mailbox-permissions` 命令會擷取與指定實體信箱相關聯的信箱許可。
```
aws workmail list-mailbox-permissions \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
輸出：
```
{
"Permissions": [
{
"GranteeId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"GranteeType": "USER",
"PermissionValues": [
"FULL_ACCESS"
]
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-mailbox-permissions.html)。
### `list-organizations`
以下程式碼範例顯示如何使用 `list-organizations`。
**AWS CLI**
**擷取組織清單**
下列 `list-organizations` 命令會擷取客戶組織的摘要。
```
aws workmail list-organizations
```
輸出：
```
{
"OrganizationSummaries": [
{
"OrganizationId": "m-d281d0a2fd824be5b6cd3d3ce909fd27",
"Alias": "exampleAlias",
"State": "Active"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListOrganizations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-organizations.html)。
### `list-resource-delegates`
以下程式碼範例顯示如何使用 `list-resource-delegates`。
**AWS CLI**
**列出資源的委派**
下列 `list-resource-delegates` 命令會擷取與指定資源關聯的委派。
```
aws workmail list-resource-delegates \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-68bf2d3b1c0244aab7264c24b9217443
```
輸出：
```
{
"Delegates": [
{
"Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Type": "USER"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListResourceDelegates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-resource-delegates.html)。
### `list-resources`
以下程式碼範例顯示如何使用 `list-resources`。
**AWS CLI**
**擷取資源清單**
下列`list-resources`命令會擷取指定組織的資源摘要。
```
aws workmail list-resources \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
輸出：
```
{
"Resources": [
{
"Id": "r-7afe0efbade843a58cdc10251fce992c",
"Name": "exampleRoom1",
"Type": "ROOM",
"State": "ENABLED"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-resources.html)。
### `list-tags-for-resource`
以下程式碼範例顯示如何使用 `list-tags-for-resource`。
**AWS CLI**
**列出資源的標籤**
下列 `list-tags-for-resource` 範例會列出指定 Amazon WorkMail 組織的標籤。
```
aws workmail list-tags-for-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza
```
輸出：
```
{
"Tags": [
{
"Key": "priority",
"Value": "1"
}
]
}
```
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[標記組織](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-tags-for-resource.html)。
### `list-users`
以下程式碼範例顯示如何使用 `list-users`。
**AWS CLI**
**擷取使用者清單**
下列 `list-users` 命令會擷取指定組織中使用者的摘要。
```
aws workmail list-users \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
輸出：
```
{
"Users": [
{
"Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Email": "exampleUser1@site.awsapps.com",
"Name": "exampleUser1",
"State": "ENABLED",
"UserRole": "USER",
"EnabledDate": 1532459261.827
},
{
"Id": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"Name": "exampleGuestUser",
"State": "DISABLED",
"UserRole": "SYSTEM_USER"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-users.html)。
### `put-access-control-rule`
以下程式碼範例顯示如何使用 `put-access-control-rule`。
**AWS CLI**
**放置新存取控制規則**
下列 `put-access-control-rule` 範例會拒絕指定使用者存取指定 Amazon WorkMail 組織。
```
aws workmail put-access-control-rule \
--name "myRule" \
--effect "DENY" \
--description "my rule" \
--user-ids "S-1-1-11-1111111111-2222222222-3333333333-3333" \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[使用存取控制規則](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [PutAccessControlRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/put-access-control-rule.html)。
### `put-mailbox-permissions`
以下程式碼範例顯示如何使用 `put-mailbox-permissions`。
**AWS CLI**
**設定信箱許可**
下列 `put-mailbox-permissions` 命令會設定指定承授者 (使用者或群組) 的完整存取許可。實體代表信箱的擁有者。
```
aws workmail put-mailbox-permissions \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--grantee-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--permission-values FULL_ACCESS
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [PutMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/put-mailbox-permissions.html)。
### `register-to-work-mail`
以下程式碼範例顯示如何使用 `register-to-work-mail`。
**AWS CLI**
**註冊現有或已停用的實體**
下列 `register-to-work-mail` 命令可讓指定的現有實體 (使用者、群組或資源) 能夠使用 Amazon WorkMail。
```
aws workmail register-to-work-mail \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--email exampleGroup1@site.awsapps.com
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [RegisterToWorkMail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/register-to-work-mail.html)。
### `reset-password`
以下程式碼範例顯示如何使用 `reset-password`。
**AWS CLI**
**重設使用者的密碼**
下列 `reset-password` 命令會重設指定使用者的密碼。
```
aws workmail reset-password \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--password examplePa$$w0rd
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ResetPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/reset-password.html)。
### `tag-resource`
以下程式碼範例顯示如何使用 `tag-resource`。
**AWS CLI**
**將標籤套用至資源**
下列 `tag-resource` 範例會將索引鍵為 "priority" 且值為 "1" 的標籤套用至指定的 Amazon WorkMail 組織。
```
aws workmail tag-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
--tags "Key=priority,Value=1"
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[標記組織](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/tag-resource.html)。
### `untag-resource`
以下程式碼範例顯示如何使用 `untag-resource`。
**AWS CLI**
**取消標記資源**
下列 `untag-resource` 範例會將指定的標籤從指定的 Amazon WorkMail 組織中移除。
```
aws workmail untag-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
--tag-keys "priority"
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[標記組織](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/untag-resource.html)。
### `update-mailbox-quota`
以下程式碼範例顯示如何使用 `update-mailbox-quota`。
**AWS CLI**
**更新使用者的信箱配額**
下列 `update-mailbox-quota` 命令會變更指定使用者的信箱配額。
```
aws workmail update-mailbox-quota \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--mailbox-quota 40000
```
此命令不會產生輸出。
如需詳細資訊，請參閱《Amazon WorkMail 管理員指南》**中的[管理使用者帳戶](https://docs.aws.amazon.com/workmail/latest/adminguide/manage-users.html)。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateMailboxQuota](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-mailbox-quota.html)。
### `update-primary-email-address`
以下程式碼範例顯示如何使用 `update-primary-email-address`。
**AWS CLI**
**更新主要電子郵件地址**
下列 `update-primary-email-address` 命令會更新指定實體 (使用者、群組或資源) 的主要電子郵件地址。
```
aws workmail update-primary-email-address \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--email exampleUser2@site.awsapps.com
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdatePrimaryEmailAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-primary-email-address.html)。
### `update-resource`
以下程式碼範例顯示如何使用 `update-resource`。
**AWS CLI**
**更新資源**
下列 `update-resource` 命令會更新指定資源的名稱。
```
aws workmail update-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c \
--name exampleRoom2
```
此命令不會產生輸出。
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-resource.html)。