Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 

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

# 를 사용한 Amazon WorkMail 예제 AWS CLI
<a name="cli_2_workmail_code_examples"></a>

다음 코드 예제에서는 AWS Command Line Interface Amazon WorkMail에서를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

**Topics**
+ [작업](#actions)

## 작업
<a name="actions"></a>

### `associate-delegate-to-resource`
<a name="workmail_AssociateDelegateToResource_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_AssociateMemberToGroup_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_CreateAlias_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_CreateGroup_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_CreateResource_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_CreateUser_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeleteAccessControlRule_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Working with Access Control Rules](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`
<a name="workmail_DeleteAlias_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeleteGroup_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeleteMailboxPermissions_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeleteResource_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeleteUser_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DeregisterFromWorkMail_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DescribeGroup_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DescribeOrganization_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Working with Organizations](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`
<a name="workmail_DescribeResource_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DescribeUser_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DisassociateDelegateFromResource_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_DisassociateMemberFromGroup_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_GetAccessControlEffect_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Working with Access Control Rules](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`
<a name="workmail_GetMailboxDetails_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Managing User Accounts](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`
<a name="workmail_ListAccessControlRules_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Working with Access Control Rules](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`
<a name="workmail_ListAliases_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListGroupMembers_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListGroups_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListMailboxPermissions_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListOrganizations_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListResourceDelegates_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListResources_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ListTagsForResource_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Tagging an Organization](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`
<a name="workmail_ListUsers_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_PutAccessControlRule_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Working with Access Control Rules](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`
<a name="workmail_PutMailboxPermissions_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_RegisterToWorkMail_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_ResetPassword_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_TagResource_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Tagging an Organization](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`
<a name="workmail_UntagResource_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Tagging an Organization](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`
<a name="workmail_UpdateMailboxQuota_cli_2_topic"></a>

다음 코드 예시에서는 `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 관리자 안내서*의 [Managing User Accounts](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`
<a name="workmail_UpdatePrimaryEmailAddress_cli_2_topic"></a>

다음 코드 예시에서는 `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`
<a name="workmail_UpdateResource_cli_2_topic"></a>

다음 코드 예시에서는 `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) 섹션을 참조하세요.