Beispiele für die Verwendung von Amazon WorkMail mit AWS CLI - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung von Amazon WorkMail mit AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Amazon WorkMail nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie associate-delegate-to-resource verwendet wird.

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.

Das folgende Codebeispiel zeigt, wie associate-member-to-group verwendet wird.

AWS CLI

So fügen Sie einer Gruppe ein Mitglied hinzu

Mit dem folgenden associate-member-to-group-Befehl wird das angegebene Mitglied zu einer Gruppe hinzugefügt.

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.

Das folgende Codebeispiel zeigt, wie create-alias verwendet wird.

AWS CLI

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.

  • API-Details finden Sie unter CreateAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-group verwendet wird.

AWS CLI

Neue Gruppe erstellen

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

  • API-Details finden Sie unter CreateGroup in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-resource verwendet wird.

AWS CLI

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

  • API-Details finden Sie unter CreateResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-user verwendet wird.

AWS CLI

Um einen neuen Benutzer zu erstellen

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

  • API-Details finden Sie unter CreateUser in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-access-control-rule verwendet wird.

AWS CLI

So löschen Sie eine Zugriffssteuerungsregel

Im folgenden Beispiel für delete-access-control-rule wird die angegebene Zugriffskontrollregel aus der angegebenen Amazon-WorkMail-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 Zugriffssteuerungsregeln im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie delete-alias verwendet wird.

AWS CLI

Löschen eines 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.

  • API-Details finden Sie unter DeleteAlias in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-group verwendet wird.

AWS CLI

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.

  • API-Details finden Sie unter DeleteGroup in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-mailbox-permissions verwendet wird.

AWS CLI

So löschen Sie Postfachberechtigungen

Mit dem folgenden delete-mailbox-permissions-Befehl werden Postfachberechtigungen gelöscht, 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.

Das folgende Codebeispiel zeigt, wie delete-resource verwendet wird.

AWS CLI

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.

  • API-Details finden Sie unter DeleteResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-user verwendet wird.

AWS CLI

Benutzer löschen

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.

  • API-Details finden Sie unter DeleteUser in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie deregister-from-work-mail verwendet wird.

AWS CLI

So deaktivieren Sie eine vorhandene Entität

Der folgende deregister-from-work-mail-Befehl deaktiviert die Verwendung von Amazon WorkMail für eine vorhandene Entität (Benutzer, Gruppe oder Ressource).

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.

Das folgende Codebeispiel zeigt, wie describe-group verwendet wird.

AWS CLI

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

  • API-Details finden Sie unter DescribeGroup in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-organization verwendet wird.

AWS CLI

So rufen Sie Informationen für eine Organisation ab

Mit dem folgenden describe-organization-Befehl werden Informationen für die angegebene Amazon-WorkMail-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 Organisation im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie describe-resource verwendet wird.

AWS CLI

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

Das folgende Codebeispiel zeigt, wie describe-user verwendet wird.

AWS CLI

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
}

  • API-Details finden Sie unter DescribeUser in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie disassociate-delegate-from-resource verwendet wird.

AWS CLI

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.

Das folgende Codebeispiel zeigt, wie disassociate-member-from-group verwendet wird.

AWS CLI

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.

Das folgende Codebeispiel zeigt, wie get-access-control-effect verwendet wird.

AWS CLI

So rufen Sie die Auswirkung von Zugriffskontrollregeln ab

Im folgenden Beispiel für get-access-control-effect werden die Auswirkungen der Zugriffssteuerungsregeln der angegebenen Amazon-WorkMail-Organisation auf die angegebene IP-Adresse, Zugriffsprotokollaktion und Benutzer-ID abgerufen.

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 Zugriffssteuerungsregeln im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie get-mailbox-details verwendet wird.

AWS CLI

So rufen Sie die Postfachdetails eines Benutzers ab

Mit dem folgenden get-mailbox-details-Befehl werden Details zum Postfach des angegebenen Benutzers abgerufen.

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 Verwalten von Benutzerkonten im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie list-access-control-rules verwendet wird.

AWS CLI

So listen Sie Zugriffskontrollregeln auf

Im folgenden Beispiel für list-access-control-rules werden die Zugriffssteuerungsregeln für die angegebene Amazon-WorkMail-Organisation aufgelistet.

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 Zugriffssteuerungsregeln im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie list-aliases verwendet wird.

AWS CLI

So listen Sie die Aliasse für ein Mitglied auf

Der folgende list-aliases-Befehl listet die Aliasse 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"
    ]
}

  • API-Details finden Sie unter ListAliases in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-group-members verwendet wird.

AWS CLI

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

Das folgende Codebeispiel zeigt, wie list-groups verwendet wird.

AWS CLI

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

  • API-Details finden Sie unter ListGroups in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-mailbox-permissions verwendet wird.

AWS CLI

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

Das folgende Codebeispiel zeigt, wie list-organizations verwendet wird.

AWS CLI

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

Das folgende Codebeispiel zeigt, wie list-resource-delegates verwendet wird.

AWS CLI

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

Das folgende Codebeispiel zeigt, wie list-resources verwendet wird.

AWS CLI

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

  • API-Details finden Sie unter ListResources in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags für eine Ressource auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags für die angegebene Amazon-WorkMail-Organisation aufgelistet.

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 Markieren einer Organisation im Administratorhandbuch zu Amazon-WorkMail.

Das folgende Codebeispiel zeigt, wie list-users verwendet wird.

AWS CLI

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

  • API-Details finden Sie unter ListUsers in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-access-control-rule verwendet wird.

AWS CLI

So setzen Sie eine neue Zugriffskontrollregel

Im folgenden Beispiel für put-access-control-rule wird dem angegebenen Benutzer der Zugriff auf die angegebene Amazon-WorkMail-Organisation verweigert.

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 Zugriffssteuerungsregeln im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie put-mailbox-permissions verwendet wird.

AWS CLI

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.

Das folgende Codebeispiel zeigt, wie register-to-work-mail verwendet wird.

AWS CLI

So registrieren Sie eine vorhandene oder deaktivierte Entität

Der folgende register-to-work-mail-Befehl ermöglicht es der angegebenen vorhandenen Entität (Benutzer, Gruppe oder Ressource), Amazon WorkMail zu verwenden.

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.

Das folgende Codebeispiel zeigt, wie reset-password verwendet wird.

AWS CLI

Benutzerpasswort zurücksetzen

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.

  • API-Details finden Sie unter ResetPassword in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So wenden Sie einen Tag auf eine Ressource an

Im folgenden Beispiel für tag-resource wird der angegebenen Amazon-WorkMail-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 Markieren einer Organisation im Administratorhandbuch zu Amazon-WorkMail.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags von einer Ressource

Im folgenden Beispiel für untag-resource wird der angegebene Tag von der angegebenen Amazon-WorkMail-Organisation entfernt.

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 Markieren einer Organisation im Administratorhandbuch zu Amazon-WorkMail.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-mailbox-quota verwendet wird.

AWS CLI

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 Verwalten von Benutzerkonten im Administratorhandbuch zu Amazon WorkMail.

Das folgende Codebeispiel zeigt, wie update-primary-email-address verwendet wird.

AWS CLI

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.

Das folgende Codebeispiel zeigt, wie update-resource verwendet wird.

AWS CLI

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.

  • API-Details finden Sie unter UpdateResource in der AWS CLI-Befehlsreferenz.