WorkMail Contoh Amazon menggunakan AWS CLI

Untuk menambahkan delegasi ke sumber daya

associate-delegate-to-resourcePerintah berikut menambahkan delegasi ke sumber daya.

aws workmail associate-delegate-to-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-68bf2d3b1c0244aab7264c24b9217443 \
    --entity-id S-1-1-11-1111111111-2222222222-3333333333-3333

Perintah ini tidak menghasilkan output.

Untuk menambahkan anggota ke grup

associate-member-to-groupPerintah berikut menambahkan anggota yang ditentukan ke grup.

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

Perintah ini tidak menghasilkan output.

Untuk membuat alias

create-aliasPerintah berikut membuat alias untuk entitas tertentu (pengguna atau grup).

aws workmail create-alias \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
    --alias exampleAlias@site.awsapps.com

Perintah ini tidak menghasilkan output.

Untuk membuat grup baru

create-groupPerintah berikut membuat grup baru untuk organisasi tertentu.

aws workmail create-group \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --name exampleGroup1

Output:

{
    "GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444"
}

Untuk membuat sumber daya baru

create-resourcePerintah berikut membuat sumber daya baru (ruang rapat) untuk organisasi tertentu.

aws workmail create-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --name exampleRoom1 \
    --type ROOM

Output:

{
    "ResourceId": "r-7afe0efbade843a58cdc10251fce992c"
}

Untuk membuat pengguna baru

create-userPerintah berikut menciptakan pengguna baru.

aws workmail create-user \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --name exampleName \
    --display-name exampleDisplayName \
    --password examplePa$$w0rd

Output:

{
    "UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333"
}

Untuk menghapus aturan kontrol akses

delete-access-control-ruleContoh berikut menghapus aturan kontrol akses yang ditentukan dari WorkMail organisasi Amazon yang ditentukan.

aws workmail delete-access-control-rule \
    --organization-id m-n1pq2345678r901st2u3vx45x6789yza \
    --name "myRule"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Bekerja dengan Aturan Kontrol Akses di Panduan WorkMail Administrator Amazon.

Untuk menghapus alias

delete-aliasPerintah berikut menghapus alias untuk entitas tertentu (pengguna atau grup).

aws workmail delete-alias \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
    --alias exampleAlias@site.awsapps.com

Perintah ini tidak menghasilkan output.

Untuk menghapus grup yang ada

delete-groupPerintah berikut menghapus grup yang ada dari Amazon WorkMail.

aws workmail delete-group \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --group-id S-1-1-11-1122222222-2222233333-3333334444-4444

Perintah ini tidak menghasilkan output.

Untuk menghapus izin kotak pesan

delete-mailbox-permissionsPerintah berikut menghapus izin kotak pesan yang sebelumnya diberikan kepada pengguna atau grup. Entitas mewakili pengguna yang memiliki kotak pesan, dan penerima hibah mewakili pengguna atau grup yang akan menghapus izin.

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

Perintah ini tidak menghasilkan output.

Untuk menghapus sumber daya yang ada

delete-resourcePerintah berikut menghapus sumber daya yang ada dari Amazon WorkMail.

aws workmail delete-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-7afe0efbade843a58cdc10251fce992c

Perintah ini tidak menghasilkan output.

Untuk menghapus pengguna

delete-userPerintah berikut menghapus pengguna yang ditentukan dari Amazon WorkMail dan semua sistem berikutnya.

aws workmail delete-user \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --user-id S-1-1-11-1111111111-2222222222-3333333333-3333

Perintah ini tidak menghasilkan output.

Untuk menonaktifkan entitas yang ada

deregister-from-work-mailPerintah berikut menonaktifkan entitas yang ada (pengguna, grup, atau sumber daya) dari menggunakan Amazon WorkMail.

aws workmail deregister-from-work-mail \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --entity-id S-1-1-11-1111111111-2222222222-3333333333-3333

Perintah ini tidak menghasilkan output.

Untuk mengambil informasi untuk grup

describe-groupPerintah berikut mengambil informasi tentang grup yang ditentukan.

aws workmail describe-group \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --group-id S-1-1-11-1122222222-2222233333-3333334444-4444

Output:

{
    "GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
    "Name": "exampleGroup1",
    "State": "ENABLED"
}

Untuk mengambil informasi untuk suatu organisasi

describe-organizationPerintah berikut mengambil informasi untuk WorkMail organisasi Amazon yang ditentukan.

aws workmail describe-organization \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27

Output:

{
    "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"
}

Untuk informasi selengkapnya, lihat Bekerja dengan Organizations di Panduan WorkMail Administrator Amazon.

Untuk mengambil informasi untuk sumber daya

describe-resourcePerintah berikut mengambil informasi tentang sumber daya yang ditentukan.

aws workmail describe-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-7afe0efbade843a58cdc10251fce992c

Output:

{
    "ResourceId": "r-7afe0efbade843a58cdc10251fce992c",
    "Name": "exampleRoom1",
    "Type": "ROOM",
    "BookingOptions": {
        "AutoAcceptRequests": true,
        "AutoDeclineRecurringRequests": false,
        "AutoDeclineConflictingRequests": true
    },
    "State": "ENABLED"
}

Untuk mengambil informasi pengguna

describe-userPerintah berikut mengambil informasi tentang pengguna yang ditentukan.

aws workmail describe-user \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --user-id S-1-1-11-1111111111-2222222222-3333333333-3333

Output:

{
    "UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333",
    "Name": "exampleUser1",
    "Email": "exampleUser1@site.awsapps.com",
    "DisplayName": "",
    "State": "ENABLED",
    "UserRole": "USER",
    "EnabledDate": 1532459261.827
}

Untuk menghapus anggota dari sumber daya

disassociate-delegate-from-resourcePerintah berikut menghapus anggota yang ditentukan dari sumber daya.

ws workmail disassociate-delegate-from-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-68bf2d3b1c0244aab7264c24b9217443 \
    --entity-id S-1-1-11-1111111111-2222222222-3333333333-3333

Perintah ini tidak menghasilkan output.

Untuk menghapus anggota dari grup

disassociate-member-from-groupPerintah berikut menghapus anggota yang ditentukan dari grup.

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

Perintah ini tidak menghasilkan output.

Untuk mendapatkan efek aturan kontrol akses

get-access-control-effectContoh berikut mengambil efek dari aturan kontrol akses WorkMail organisasi Amazon yang ditentukan untuk alamat IP tertentu, tindakan protokol akses, dan ID pengguna.

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"

Output:

{
    "Effect": "DENY",
    "MatchedRules": [
        "myRule"
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Aturan Kontrol Akses di Panduan WorkMail Administrator Amazon.

Untuk mendapatkan detail kotak pesan pengguna

get-mailbox-detailsPerintah berikut mengambil rincian tentang kotak pesan pengguna yang ditentukan.

aws workmail get-mailbox-details \
    --organization-id m-n1pq2345678r901st2u3vx45x6789yza \
    --user-id S-1-1-11-1111111111-2222222222-3333333333-3333

Output:

{
    "MailboxQuota": 51200,
    "MailboxSize": 0.03890800476074219
}

Untuk informasi selengkapnya, lihat Mengelola Akun Pengguna di Panduan WorkMail Administrator Amazon.

Untuk membuat daftar aturan kontrol akses

list-access-control-rulesContoh berikut mencantumkan aturan kontrol akses untuk WorkMail organisasi Amazon yang ditentukan.

aws workmail list-access-control-rules \
    --organization-id m-n1pq2345678r901st2u3vx45x6789yza

Output:

{
    "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
        }
    ]
}

Untuk informasi selengkapnya, lihat Bekerja dengan Aturan Kontrol Akses di Panduan WorkMail Administrator Amazon.

Untuk daftar alias untuk anggota

list-aliasesPerintah berikut mencantumkan alias untuk anggota tertentu (pengguna atau grup).

aws workmail list-aliases \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --entity-id S-1-1-11-1111111111-2222222222-3333333333-3333

Output:

{
    "Aliases": [
        "exampleAlias@site.awsapps.com",
        "exampleAlias1@site.awsapps.com"
    ]
}

Untuk daftar anggota grup

list-group-membersPerintah berikut mencantumkan anggota grup yang ditentukan.

aws workmail list-group-members \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --group-id S-1-1-11-1122222222-2222233333-3333334444-4444

Output:

{
    "Members": [
        {
            "Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
            "Name": "exampleUser1",
            "Type": "USER",
            "State": "ENABLED",
            "EnabledDate": 1532459261.827
        }
    ]
}

Untuk mengambil daftar grup

list-groupsPerintah berikut mengambil ringkasan grup dalam organisasi yang ditentukan.

aws workmail list-groups \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27

Output:

{
    "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"
        }
    ]
}

Untuk mengambil izin kotak pesan

list-mailbox-permissionsPerintah berikut mengambil izin kotak pesan yang terkait dengan kotak pesan entitas tertentu.

aws workmail list-mailbox-permissions \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --entity-id S-1-1-11-1111111111-2222222222-3333333333-3333

Output:

{
    "Permissions": [
        {
            "GranteeId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
            "GranteeType": "USER",
            "PermissionValues": [
                "FULL_ACCESS"
            ]
        }
    ]
}

Untuk mengambil daftar organisasi

list-organizationsPerintah berikut mengambil ringkasan dari organisasi pelanggan.

aws workmail list-organizations

Output:

{
    "OrganizationSummaries": [
        {
            "OrganizationId": "m-d281d0a2fd824be5b6cd3d3ce909fd27",
            "Alias": "exampleAlias",
            "State": "Active"
        }
    ]
}

Untuk membuat daftar delegasi untuk sumber daya

list-resource-delegatesPerintah berikut mengambil delegasi yang terkait dengan sumber daya yang ditentukan.

aws workmail list-resource-delegates \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-68bf2d3b1c0244aab7264c24b9217443

Output:

{
    "Delegates": [
        {
            "Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
            "Type": "USER"
        }
    ]
}

Untuk mengambil daftar sumber daya

list-resourcesPerintah berikut mengambil ringkasan sumber daya untuk organisasi yang ditentukan.

aws workmail list-resources \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27

Output:

{
    "Resources": [
        {
            "Id": "r-7afe0efbade843a58cdc10251fce992c",
            "Name": "exampleRoom1",
            "Type": "ROOM",
            "State": "ENABLED"
        }
    ]
}

Untuk membuat daftar tag untuk sumber daya

list-tags-for-resourceContoh berikut mencantumkan tag untuk WorkMail organisasi Amazon yang ditentukan.

aws workmail list-tags-for-resource \
    --resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza

Output:

{
    "Tags": [
        {
            "Key": "priority",
            "Value": "1"
        }
    ]
}

Untuk informasi selengkapnya, lihat Menandai Organisasi di Panduan WorkMail Administrator Amazon.

Untuk mengambil daftar pengguna

list-usersPerintah berikut mengambil ringkasan dari pengguna dalam organisasi tertentu.

aws workmail list-users \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27

Output:

{
    "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"
        }
    ]
}

Untuk menempatkan aturan kontrol akses baru

put-access-control-ruleContoh berikut menyangkal akses pengguna yang ditentukan ke WorkMail organisasi Amazon yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Bekerja dengan Aturan Kontrol Akses di Panduan WorkMail Administrator Amazon.

Untuk mengatur izin kotak pesan

put-mailbox-permissionsPerintah berikut menetapkan izin akses penuh untuk penerima hibah tertentu (pengguna atau grup). Entitas mewakili pemilik kotak pesan.

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

Perintah ini tidak menghasilkan output.

Untuk mendaftarkan entitas yang sudah ada atau dinonaktifkan

register-to-work-mailPerintah berikut memungkinkan entitas yang sudah ada (pengguna, grup, atau sumber daya) yang ditentukan untuk menggunakan 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

Perintah ini tidak menghasilkan output.

Untuk mengatur ulang kata sandi pengguna

reset-passwordPerintah berikut mengatur ulang kata sandi untuk pengguna yang ditentukan.

aws workmail reset-password \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
    --password examplePa$$w0rd

Perintah ini tidak menghasilkan output.

Untuk menerapkan tag ke sumber daya

tag-resourceContoh berikut menerapkan tag dengan kunci “prioritas” dan nilai “1" ke WorkMail organisasi Amazon yang ditentukan.

aws workmail tag-resource \
    --resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
    --tags "Key=priority,Value=1"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Organisasi di Panduan WorkMail Administrator Amazon.

Untuk menghapus tag sumber daya

untag-resourceContoh berikut menghapus tag yang ditentukan dari WorkMail organisasi Amazon yang ditentukan.

aws workmail untag-resource \
    --resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
    --tag-keys "priority"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Organisasi di Panduan WorkMail Administrator Amazon.

Untuk memperbarui kuota kotak pesan pengguna

update-mailbox-quotaPerintah berikut mengubah kuota kotak pesan pengguna yang ditentukan.

aws workmail update-mailbox-quota \
    --organization-id m-n1pq2345678r901st2u3vx45x6789yza \
    --user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
    --mailbox-quota 40000

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola Akun Pengguna di Panduan WorkMail Administrator Amazon.

Untuk memperbarui alamat email utama

update-primary-email-addressPerintah berikut memperbarui alamat email utama dari entitas tertentu (pengguna, grup, atau sumber daya).

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

Perintah ini tidak menghasilkan output.

Untuk memperbarui sumber daya

update-resourcePerintah berikut memperbarui nama sumber daya yang ditentukan.

aws workmail update-resource \
    --organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
    --resource-id r-7afe0efbade843a58cdc10251fce992c \
    --name exampleRoom2

Perintah ini tidak menghasilkan output.