WorkMail Amazon-Beispiele unter AWS CLI

So fügen Sie einen Delegierten zu einer Ressource hinzu

Der folgende associate-delegate-to-resource-Befehl fügt einen Delegierten einer Ressource hinzu.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So fügen Sie einer Gruppe ein Mitglied hinzu

Der folgende associate-member-to-group-Befehl fügt das angegebene Mitglied zu einer Gruppe hinzu.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So erstellen Sie einen Alias

Der folgende create-alias-Befehl erstellt einen Alias für die angegebene Entität (Benutzer oder Gruppe).

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So erstellen Sie eine neue Gruppe

Der folgende create-group-Befehl erstellt eine neue Gruppe für die angegebene Organisation.

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

Ausgabe:

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

So erstellen Sie eine neue Ressource

Der folgende create-resource-Befehl erstellt eine neue Ressource (Besprechungsraum) für die angegebene Organisation.

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

Ausgabe:

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

So erstellen Sie einen neuen Benutzer

Der folgende create-user-Befehl erstellt einen neuen Benutzer.

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

Ausgabe:

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

Um eine Zugriffskontrollregel zu löschen

Im folgenden delete-access-control-rule Beispiel wird die angegebene Zugriffskontrollregel aus der angegebenen WorkMail Amazon-Organisation gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit Zugriffskontrollregeln im WorkMail Amazon-Administratorhandbuch.

So löschen Sie einen Alias

Der folgende delete-alias-Befehl löscht den Alias für die angegebene Entität (Benutzer oder Gruppe).

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie eine vorhandene Gruppe

Der folgende delete-group Befehl löscht eine vorhandene Gruppe aus Amazon WorkMail.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie Postfachberechtigungen

Der folgende delete-mailbox-permissions-Befehl löscht Postfachberechtigungen, die zuvor einem Benutzer oder einer Gruppe gewährt wurden. Die Entität stellt den Benutzer dar, dem das Postfach gehört, und der Empfänger stellt den Benutzer oder die Gruppe, für den bzw. die Berechtigungen gelöscht werden sollen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie eine vorhandene Ressource

Der folgende delete-resource Befehl löscht eine vorhandene Ressource aus Amazon WorkMail.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So löschen Sie einen Benutzer

Der folgende delete-user Befehl löscht den angegebenen Benutzer aus Amazon WorkMail und allen nachfolgenden Systemen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So deaktivieren Sie eine vorhandene Entität

Der folgende deregister-from-work-mail Befehl verhindert, dass eine vorhandene Entität (Benutzer, Gruppe oder Ressource) Amazon WorkMail verwendet.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So rufen Sie Informationen für eine Gruppe ab

Der folgende describe-group-Befehl ruft Informationen zur angegebenen Gruppe ab.

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

Ausgabe:

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

So rufen Sie Informationen für eine Organisation ab

Mit dem folgenden describe-organization Befehl werden Informationen für die angegebene WorkMail Amazon-Organisation abgerufen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Arbeiten mit Organisationen im WorkMail Amazon-Administratorhandbuch.

So rufen Sie Informationen für eine Ressource ab

Der folgende describe-resource-Befehl ruft Informationen zur angegebenen Ressource ab.

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

Ausgabe:

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

So rufen Sie Benutzerinformationen ab

Der folgende describe-user-Befehl ruft Informationen über den angegebenen Benutzer ab.

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

Ausgabe:

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

So entfernen Sie ein Mitglied aus einer Gruppe

Der folgende disassociate-delegate-from-resource-Befehl entfernt das angegebene Mitglied aus einer Ressource.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So entfernen Sie ein Mitglied aus einer Gruppe

Der folgende disassociate-member-from-group-Befehl entfernt das angegebene Mitglied aus einer Gruppe

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So rufen Sie die Auswirkung von Zugriffskontrollregeln ab

Das folgende get-access-control-effect Beispiel ruft die Auswirkungen der Zugriffskontrollregeln der angegebenen WorkMail Amazon-Organisation für die angegebene IP-Adresse, die Zugriffsprotokollaktion und die Benutzer-ID ab.

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"

Ausgabe:

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

Weitere Informationen finden Sie unter Arbeiten mit Zugriffskontrollregeln im WorkMail Amazon-Administratorhandbuch.

So rufen Sie die Postfachdetails eines Benutzers ab

Der folgende get-mailbox-details-Befehl ruft Details zum Postfach des angegebenen Benutzers ab.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Benutzerkonten verwalten im WorkMail Amazon-Administratorhandbuch.

So listen Sie Zugriffskontrollregeln auf

Das folgende list-access-control-rules Beispiel listet die Zugriffskontrollregeln für die angegebene WorkMail Amazon-Organisation auf.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Arbeiten mit Zugriffskontrollregeln im WorkMail Amazon-Administratorhandbuch.

So listen Sie die Aliasnamen für ein Mitglied auf

Der folgende list-aliases-Befehl listet die Aliasnamen für das angegebene Mitglied (Benutzer oder Gruppe) auf.

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

Ausgabe:

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

So listen Sie Gruppenmitglieder auf

Der folgende list-group-members-Befehl listet die Mitglieder der angegebenen Gruppe auf.

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

Ausgabe:

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

So rufen Sie eine Liste von Gruppen ab

Der folgende list-groups-Befehl ruft Zusammenfassungen der Gruppen in der angegebenen Organisation ab.

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

Ausgabe:

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

So rufen Sie Postfachberechtigungen ab

Der folgende list-mailbox-permissions-Befehl ruft die Postfachberechtigungen ab, die dem Postfach der angegebenen Entität zugeordnet sind.

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

Ausgabe:

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

So rufen Sie eine Liste von Organisationen ab

Der folgende list-organizations-Befehl ruft Zusammenfassungen der Organisationen des Kunden ab.

aws workmail list-organizations

Ausgabe:

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

So listen Sie die Delegierten für eine Ressource auf

Der folgende list-resource-delegates-Befehl ruft die Delegierten ab, die der angegebenen Ressource zugeordnet sind.

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

Ausgabe:

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

So rufen Sie eine Liste von Ressourcen ab

Der folgende list-resources-Befehl ruft Zusammenfassungen der Ressourcen für die angegebene Organisation ab.

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

Ausgabe:

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

So listen Sie die Tags für eine Ressource auf

Das folgende list-tags-for-resource Beispiel listet die Tags für die angegebene WorkMail Amazon-Organisation auf.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Tagging an Organization im WorkMail Amazon-Administratorhandbuch.

So rufen Sie eine Liste der Benutzer ab

Der folgende list-users-Befehl ruft Zusammenfassungen der Benutzer in der angegebenen Organisation ab.

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

Ausgabe:

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

So setzen Sie eine neue Zugriffskontrollregel

Das folgende put-access-control-rule Beispiel verweigert dem angegebenen Benutzer den Zugriff auf die angegebene WorkMail Amazon-Organisation.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit Zugriffskontrollregeln im WorkMail Amazon-Administratorhandbuch.

So legen Sie Postfachberechtigungen fest

Der folgende put-mailbox-permissions-Befehl legt volle Zugriffsberechtigungen für den angegebenen Empfänger (Benutzer oder Gruppe) fest. Die Entität stellt den Eigentümer des Postfachs dar.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So registrieren Sie eine vorhandene oder deaktivierte Entität

Der folgende register-to-work-mail Befehl ermöglicht der angegebenen vorhandenen Entität (Benutzer, Gruppe oder Ressource), Amazon zu verwenden 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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So setzen Sie das Benutzerpasswort zurück

Der folgende reset-password-Befehl setzt das Passwort für den angegebenen Benutzer zurück.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So wenden Sie einen Tag auf eine Ressource an

Im folgenden tag-resource Beispiel wird der angegebenen WorkMail Amazon-Organisation ein Tag mit dem Schlüssel „priority“ und dem Wert „1" zugewiesen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging an Organization im WorkMail Amazon-Administratorhandbuch.

So entfernen Sie Tags von einer Ressource

Das folgende untag-resource Beispiel entfernt das angegebene Tag aus der angegebenen WorkMail Amazon-Organisation.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging an Organization im WorkMail Amazon-Administratorhandbuch.

So aktualisieren Sie das Postfachkontingent eines Benutzers

Der folgende update-mailbox-quota-Befehl ändert das Postfachkontingent des angegebenen Benutzers.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Benutzerkonten verwalten im WorkMail Amazon-Administratorhandbuch.

So aktualisieren Sie eine primäre E-Mail-Adresse

Der folgende update-primary-email-address-Befehl aktualisiert die primäre E-Mail-Adresse der angegebenen Entität (Benutzer, Gruppe oder Ressource).

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So aktualisieren Sie eine Ressource

Der folgende update-resource-Befehl aktualisiert den Namen der angegebenen Ressource.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.