D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# WorkMail Exemples d'Amazon utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon WorkMail.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `associate-delegate-to-resource`
L'exemple de code suivant montre comment utiliser`associate-delegate-to-resource`.
**AWS CLI**
**Pour ajouter un délégué à une ressource**
La commande `associate-delegate-to-resource` suivante ajoute un délégué à une ressource.
```
aws workmail associate-delegate-to-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-68bf2d3b1c0244aab7264c24b9217443 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [AssociateDelegateToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/associate-delegate-to-resource.html)à la section *Référence des AWS CLI commandes*.
### `associate-member-to-group`
L'exemple de code suivant montre comment utiliser`associate-member-to-group`.
**AWS CLI**
**Pour ajouter un membre à un groupe**
La commande `associate-member-to-group` suivante ajoute le membre spécifié à un groupe.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [AssociateMemberToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/associate-member-to-group.html)à la section *Référence des AWS CLI commandes*.
### `create-alias`
L'exemple de code suivant montre comment utiliser`create-alias`.
**AWS CLI**
**Pour créer un alias**
La commande `create-alias` suivante crée un alias pour l’entité spécifiée (utilisateur ou groupe).
```
aws workmail create-alias \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--alias exampleAlias@site.awsapps.com
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [CreateAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-alias.html)à la section *Référence des AWS CLI commandes*.
### `create-group`
L'exemple de code suivant montre comment utiliser`create-group`.
**AWS CLI**
**Pour créer un nouveau groupe**
La commande `create-group` suivante crée un nouveau groupe pour l’organisation spécifiée.
```
aws workmail create-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleGroup1
```
Sortie :
```
{
"GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-group.html)à la section *Référence des AWS CLI commandes*.
### `create-resource`
L'exemple de code suivant montre comment utiliser`create-resource`.
**AWS CLI**
**Pour créer une ressource**
La commande `create-resource` suivante crée une nouvelle ressource (salle de réunion) pour l’organisation spécifiée.
```
aws workmail create-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleRoom1 \
--type ROOM
```
Sortie :
```
{
"ResourceId": "r-7afe0efbade843a58cdc10251fce992c"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-resource.html)à la section *Référence des AWS CLI commandes*.
### `create-user`
L'exemple de code suivant montre comment utiliser`create-user`.
**AWS CLI**
**Pour créer un nouvel utilisateur**
La commande `create-user` suivante crée un nouvel utilisateur.
```
aws workmail create-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--name exampleName \
--display-name exampleDisplayName \
--password examplePa$$w0rd
```
Sortie :
```
{
"UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333"
}
```
+ Pour plus de détails sur l'API, reportez-vous [CreateUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/create-user.html)à la section *Référence des AWS CLI commandes*.
### `delete-access-control-rule`
L'exemple de code suivant montre comment utiliser`delete-access-control-rule`.
**AWS CLI**
**Pour supprimer une règle de contrôle d’accès**
L'`delete-access-control-rule`exemple suivant supprime la règle de contrôle d'accès spécifiée de l' WorkMail organisation Amazon spécifiée.
```
aws workmail delete-access-control-rule \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--name "myRule"
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Travailler avec les règles de contrôle d'accès](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteAccessControlRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-access-control-rule.html)à la section *Référence des AWS CLI commandes*.
### `delete-alias`
L'exemple de code suivant montre comment utiliser`delete-alias`.
**AWS CLI**
**Pour supprimer un alias**
La commande `delete-alias` suivante supprime l’alias pour l’entité spécifiée (utilisateur ou groupe).
```
aws workmail delete-alias \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1122222222-2222233333-3333334444-4444 \
--alias exampleAlias@site.awsapps.com
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-alias.html)à la section *Référence des AWS CLI commandes*.
### `delete-group`
L'exemple de code suivant montre comment utiliser`delete-group`.
**AWS CLI**
**Pour supprimer un groupe existant**
La `delete-group` commande suivante supprime un groupe existant d'Amazon WorkMail.
```
aws workmail delete-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-mailbox-permissions`
L'exemple de code suivant montre comment utiliser`delete-mailbox-permissions`.
**AWS CLI**
**Pour supprimer les autorisations de boîte aux lettres**
La commande `delete-mailbox-permissions` suivante supprime les autorisations de boîte aux lettres précédemment accordées à un utilisateur ou à un groupe. L’entité représente l’utilisateur propriétaire de la boîte aux lettres et le bénéficiaire représente l’utilisateur ou le groupe pour lequel les autorisations doivent être supprimées.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-mailbox-permissions.html)à la section *Référence des AWS CLI commandes*.
### `delete-resource`
L'exemple de code suivant montre comment utiliser`delete-resource`.
**AWS CLI**
**Pour supprimer une ressource existante**
La `delete-resource` commande suivante supprime une ressource existante d'Amazon WorkMail.
```
aws workmail delete-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-resource.html)à la section *Référence des AWS CLI commandes*.
### `delete-user`
L'exemple de code suivant montre comment utiliser`delete-user`.
**AWS CLI**
**Pour supprimer un utilisateur**
La `delete-user` commande suivante supprime l'utilisateur spécifié d'Amazon WorkMail et de tous les systèmes suivants.
```
aws workmail delete-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeleteUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/delete-user.html)à la section *Référence des AWS CLI commandes*.
### `deregister-from-work-mail`
L'exemple de code suivant montre comment utiliser`deregister-from-work-mail`.
**AWS CLI**
**Pour désactiver une entité existante**
La `deregister-from-work-mail` commande suivante empêche une entité existante (utilisateur, groupe ou ressource) d'utiliser Amazon WorkMail.
```
aws workmail deregister-from-work-mail \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DeregisterFromWorkMail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/deregister-from-work-mail.html)à la section *Référence des AWS CLI commandes*.
### `describe-group`
L'exemple de code suivant montre comment utiliser`describe-group`.
**AWS CLI**
**Pour récupérer les informations relatives à un groupe**
La commande `describe-group` suivante extrait les informations sur le groupe spécifié.
```
aws workmail describe-group \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
Sortie :
```
{
"GroupId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"Name": "exampleGroup1",
"State": "ENABLED"
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-group.html)à la section *Référence des AWS CLI commandes*.
### `describe-organization`
L'exemple de code suivant montre comment utiliser`describe-organization`.
**AWS CLI**
**Pour récupérer les informations d’une organisation**
La `describe-organization` commande suivante permet de récupérer les informations relatives à l' WorkMail organisation Amazon spécifiée.
```
aws workmail describe-organization \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
Sortie :
```
{
"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"
}
```
Pour plus d'informations, consultez [Working with Organizations](https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-organization.html)à la section *Référence des AWS CLI commandes*.
### `describe-resource`
L'exemple de code suivant montre comment utiliser`describe-resource`.
**AWS CLI**
**Pour récupérer les informations relatives à une ressource**
La commande `describe-resource` suivante extrait les informations sur la ressource spécifiée.
```
aws workmail describe-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c
```
Sortie :
```
{
"ResourceId": "r-7afe0efbade843a58cdc10251fce992c",
"Name": "exampleRoom1",
"Type": "ROOM",
"BookingOptions": {
"AutoAcceptRequests": true,
"AutoDeclineRecurringRequests": false,
"AutoDeclineConflictingRequests": true
},
"State": "ENABLED"
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-resource.html)à la section *Référence des AWS CLI commandes*.
### `describe-user`
L'exemple de code suivant montre comment utiliser`describe-user`.
**AWS CLI**
**Pour récupérer les informations utilisateur**
La commande `describe-user` suivante extrait les informations sur l’utilisateur spécifié.
```
aws workmail describe-user \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Sortie :
```
{
"UserId": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Name": "exampleUser1",
"Email": "exampleUser1@site.awsapps.com",
"DisplayName": "",
"State": "ENABLED",
"UserRole": "USER",
"EnabledDate": 1532459261.827
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeUser](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/describe-user.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-delegate-from-resource`
L'exemple de code suivant montre comment utiliser`disassociate-delegate-from-resource`.
**AWS CLI**
**Pour supprimer un membre d’une ressource**
La commande `disassociate-delegate-from-resource` suivante supprime le membre spécifié d’une 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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DisassociateDelegateFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/disassociate-delegate-from-resource.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-member-from-group`
L'exemple de code suivant montre comment utiliser`disassociate-member-from-group`.
**AWS CLI**
**Pour supprimer un membre d’un groupe**
La commande `disassociate-member-from-group` suivante supprime le membre spécifié d’un groupe.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DisassociateMemberFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/disassociate-member-from-group.html)à la section *Référence des AWS CLI commandes*.
### `get-access-control-effect`
L'exemple de code suivant montre comment utiliser`get-access-control-effect`.
**AWS CLI**
**Pour obtenir l’effet des règles de contrôle d’accès**
L'`get-access-control-effect`exemple suivant montre l'effet des règles de contrôle d'accès de WorkMail l'organisation Amazon spécifiée pour l'adresse IP, l'action du protocole d'accès et l'ID utilisateur spécifiés.
```
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"
```
Sortie :
```
{
"Effect": "DENY",
"MatchedRules": [
"myRule"
]
}
```
Pour plus d'informations, consultez la section [Travailler avec les règles de contrôle d'accès](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [GetAccessControlEffect](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/get-access-control-effect.html)à la section *Référence des AWS CLI commandes*.
### `get-mailbox-details`
L'exemple de code suivant montre comment utiliser`get-mailbox-details`.
**AWS CLI**
**Pour obtenir les détails de la boîte aux lettres d’un utilisateur**
La commande `get-mailbox-details` suivante extrait des détails sur la boîte aux lettres de l’utilisateur spécifié.
```
aws workmail get-mailbox-details \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Sortie :
```
{
"MailboxQuota": 51200,
"MailboxSize": 0.03890800476074219
}
```
Pour plus d'informations, consultez [la section Gestion des comptes utilisateurs](https://docs.aws.amazon.com/workmail/latest/adminguide/manage-users.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [GetMailboxDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/get-mailbox-details.html)à la section *Référence des AWS CLI commandes*.
### `list-access-control-rules`
L'exemple de code suivant montre comment utiliser`list-access-control-rules`.
**AWS CLI**
**Pour répertorier les règles de contrôle d’accès**
L'`list-access-control-rules`exemple suivant répertorie les règles de contrôle d'accès pour l' WorkMail organisation Amazon spécifiée.
```
aws workmail list-access-control-rules \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza
```
Sortie :
```
{
"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
}
]
}
```
Pour plus d'informations, consultez la section [Travailler avec les règles de contrôle d'accès](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [ListAccessControlRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-access-control-rules.html)à la section *Référence des AWS CLI commandes*.
### `list-aliases`
L'exemple de code suivant montre comment utiliser`list-aliases`.
**AWS CLI**
**Pour répertorier les alias d’un membre**
La commande `list-aliases` suivante répertorie les alias pour le membre spécifié (utilisateur ou groupe).
```
aws workmail list-aliases \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Sortie :
```
{
"Aliases": [
"exampleAlias@site.awsapps.com",
"exampleAlias1@site.awsapps.com"
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-aliases.html)à la section *Référence des AWS CLI commandes*.
### `list-group-members`
L'exemple de code suivant montre comment utiliser`list-group-members`.
**AWS CLI**
**Pour répertorier les membres d’un groupe**
La commande `list-group-members` suivante répertorie les membres du groupe spécifié.
```
aws workmail list-group-members \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--group-id S-1-1-11-1122222222-2222233333-3333334444-4444
```
Sortie :
```
{
"Members": [
{
"Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Name": "exampleUser1",
"Type": "USER",
"State": "ENABLED",
"EnabledDate": 1532459261.827
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroupMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-group-members.html)à la section *Référence des AWS CLI commandes*.
### `list-groups`
L'exemple de code suivant montre comment utiliser`list-groups`.
**AWS CLI**
**Pour extraire une liste de groupes**
La commande `list-groups` suivante extrait les récapitulatifs des groupes dans l’organisation spécifiée.
```
aws workmail list-groups \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
Sortie :
```
{
"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"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-groups.html)à la section *Référence des AWS CLI commandes*.
### `list-mailbox-permissions`
L'exemple de code suivant montre comment utiliser`list-mailbox-permissions`.
**AWS CLI**
**Pour extraire les autorisations d’accès à une boîte aux lettres**
La commande `list-mailbox-permissions` suivante extrait les autorisations d’accès à une boîte aux lettres associées à la boîte aux lettres de l’entité spécifiée.
```
aws workmail list-mailbox-permissions \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--entity-id S-1-1-11-1111111111-2222222222-3333333333-3333
```
Sortie :
```
{
"Permissions": [
{
"GranteeId": "S-1-1-11-1122222222-2222233333-3333334444-4444",
"GranteeType": "USER",
"PermissionValues": [
"FULL_ACCESS"
]
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-mailbox-permissions.html)à la section *Référence des AWS CLI commandes*.
### `list-organizations`
L'exemple de code suivant montre comment utiliser`list-organizations`.
**AWS CLI**
**Pour récupérer une liste des organisations**
La commande `list-organizations` suivante extrait les récapitulatifs des organisations du client.
```
aws workmail list-organizations
```
Sortie :
```
{
"OrganizationSummaries": [
{
"OrganizationId": "m-d281d0a2fd824be5b6cd3d3ce909fd27",
"Alias": "exampleAlias",
"State": "Active"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListOrganizations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-organizations.html)à la section *Référence des AWS CLI commandes*.
### `list-resource-delegates`
L'exemple de code suivant montre comment utiliser`list-resource-delegates`.
**AWS CLI**
**Pour répertorier les délégués d’une ressource**
La commande `list-resource-delegates` suivante extrait les délégués associés à la ressource spécifiée.
```
aws workmail list-resource-delegates \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-68bf2d3b1c0244aab7264c24b9217443
```
Sortie :
```
{
"Delegates": [
{
"Id": "S-1-1-11-1111111111-2222222222-3333333333-3333",
"Type": "USER"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListResourceDelegates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-resource-delegates.html)à la section *Référence des AWS CLI commandes*.
### `list-resources`
L'exemple de code suivant montre comment utiliser`list-resources`.
**AWS CLI**
**Pour récupérer une liste de ressources**
La commande `list-resources` suivante extrait les récapitulatifs des ressources pour l’organisation spécifiée.
```
aws workmail list-resources \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
Sortie :
```
{
"Resources": [
{
"Id": "r-7afe0efbade843a58cdc10251fce992c",
"Name": "exampleRoom1",
"Type": "ROOM",
"State": "ENABLED"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-resources.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour répertorier les balises pour une ressource**
L'`list-tags-for-resource`exemple suivant répertorie les balises pour l' WorkMail organisation Amazon spécifiée.
```
aws workmail list-tags-for-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza
```
Sortie :
```
{
"Tags": [
{
"Key": "priority",
"Value": "1"
}
]
}
```
Pour plus d'informations, consultez la section [Marquage d'une organisation](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `list-users`
L'exemple de code suivant montre comment utiliser`list-users`.
**AWS CLI**
**Pour récupérer une liste des utilisateurs**
La commande `list-users` suivante extrait les récapitulatifs des utilisateurs dans l’organisation spécifiée.
```
aws workmail list-users \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27
```
Sortie :
```
{
"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"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListUsers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/list-users.html)à la section *Référence des AWS CLI commandes*.
### `put-access-control-rule`
L'exemple de code suivant montre comment utiliser`put-access-control-rule`.
**AWS CLI**
**Pour créer une règle de contrôle d’accès**
L'`put-access-control-rule`exemple suivant refuse à l'utilisateur spécifié l'accès à l' WorkMail organisation Amazon spécifiée.
```
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
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Travailler avec les règles de contrôle d'accès](https://docs.aws.amazon.com/workmail/latest/adminguide/access-rules.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [PutAccessControlRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/put-access-control-rule.html)à la section *Référence des AWS CLI commandes*.
### `put-mailbox-permissions`
L'exemple de code suivant montre comment utiliser`put-mailbox-permissions`.
**AWS CLI**
**Pour modifier les autorisations d’accès à une boîte aux lettres**
La commande `put-mailbox-permissions` suivante définit les autorisations d’accès complètes pour le bénéficiaire (utilisateur ou groupe) spécifié. L’entité représente le propriétaire de la boîte aux lettres.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [PutMailboxPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/put-mailbox-permissions.html)à la section *Référence des AWS CLI commandes*.
### `register-to-work-mail`
L'exemple de code suivant montre comment utiliser`register-to-work-mail`.
**AWS CLI**
**Pour enregistrer une entité existante ou désactivée**
La `register-to-work-mail` commande suivante permet à l'entité existante spécifiée (utilisateur, groupe ou ressource) d'utiliser 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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [RegisterToWorkMail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/register-to-work-mail.html)à la section *Référence des AWS CLI commandes*.
### `reset-password`
L'exemple de code suivant montre comment utiliser`reset-password`.
**AWS CLI**
**Pour réinitialiser le mot de passe d’un utilisateur**
La commande `reset-password` suivante réinitialise le mot de passe de l’utilisateur spécifié.
```
aws workmail reset-password \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--password examplePa$$w0rd
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [ResetPassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/reset-password.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour appliquer une balise à une ressource**
L'`tag-resource`exemple suivant applique une balise avec la clé « priority » et la valeur « 1 » à l' WorkMail organisation Amazon spécifiée.
```
aws workmail tag-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
--tags "Key=priority,Value=1"
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage d'une organisation](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer les balises d’une ressource**
L'`untag-resource`exemple suivant supprime le tag spécifié de l' WorkMail organisation Amazon spécifiée.
```
aws workmail untag-resource \
--resource-arn arn:aws:workmail:us-west-2:111122223333:organization/m-n1pq2345678r901st2u3vx45x6789yza \
--tag-keys "priority"
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage d'une organisation](https://docs.aws.amazon.com/workmail/latest/adminguide/org-tag.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-mailbox-quota`
L'exemple de code suivant montre comment utiliser`update-mailbox-quota`.
**AWS CLI**
**Pour mettre à jour le quota de boîte aux lettres d’un utilisateur**
La commande `update-mailbox-quota` suivante modifie le quota de boîte aux lettres de l’utilisateur spécifié.
```
aws workmail update-mailbox-quota \
--organization-id m-n1pq2345678r901st2u3vx45x6789yza \
--user-id S-1-1-11-1111111111-2222222222-3333333333-3333 \
--mailbox-quota 40000
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [la section Gestion des comptes utilisateurs](https://docs.aws.amazon.com/workmail/latest/adminguide/manage-users.html) dans le manuel *Amazon WorkMail Administrator Guide*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateMailboxQuota](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-mailbox-quota.html)à la section *Référence des AWS CLI commandes*.
### `update-primary-email-address`
L'exemple de code suivant montre comment utiliser`update-primary-email-address`.
**AWS CLI**
**Pour mettre à jour une adresse e-mail principale**
La commande `update-primary-email-address` suivante met à jour l’adresse e-mail principale de l’entité (utilisateur, groupe ou ressource) spécifiée.
```
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
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdatePrimaryEmailAddress](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-primary-email-address.html)à la section *Référence des AWS CLI commandes*.
### `update-resource`
L'exemple de code suivant montre comment utiliser`update-resource`.
**AWS CLI**
**Pour mettre à jour une ressource**
La commande `update-resource` suivante met à jour le nom de la ressource spécifiée.
```
aws workmail update-resource \
--organization-id m-d281d0a2fd824be5b6cd3d3ce909fd27 \
--resource-id r-7afe0efbade843a58cdc10251fce992c \
--name exampleRoom2
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [UpdateResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/workmail/update-resource.html)à la section *Référence des AWS CLI commandes*.