Référence rapide concernant l’environnement de ligne de commande Exchange Management Shell pour Exchange 2013
S’applique à : Exchange Server 2013
Cette rubrique décrit les cmdlets les plus fréquemment utilisées disponibles dans la version de publication (RTM) et les versions ultérieures de Microsoft Exchange Server 2013. Elle fournit également des exemples de leur utilisation.
Remarque
Des informations supplémentaires seront bientôt ajoutées sur d'autres domaines de Exchange 2013.
Pour plus d'informations sur l'environnement de ligne de commande Exchange Management Shell d'Exchange 2013 et toutes les cmdlets disponibles décrites dans cette rubrique, voir les rubriques suivantes :
Sur quels élements souhaitez-vous en savoir plus ?
Actions de cmdlet communes
Les verbes suivants sont pris en charge par la plupart des cmdlets et associés à une action spécifique.
| Verbe | Description |
|---|---|
| Nouveau | Le verbe New crée une instance d'un élément, comme un nouveau paramètre de configuration, une nouvelle base de données ou un nouveau connecteur SMTP. |
| Remove | Le verbe Remove supprime une instance d'un élément, comme une boîte aux lettres ou une règle de transport. Toutes les cmdlets Remove prennent en charge les paramètres WhatIf et Confirm. Pour plus d'informations sur ces paramètres, voir Important Parameters. |
| Activer | Le verbe Enable active un paramètre ou active la messagerie pour un destinataire. |
| Disable | Le verbe Disable désactive un paramètre activé ou désactive la messagerie pour un destinataire. Toutes les tâches Disable prennent également en charge les paramètres WhatIf et Confirm. Pour plus d'informations sur ces paramètres, voir Important Parameters. |
| Set | Le verbe Set modifie des paramètres spécifiques d'un objet, tels que les alias d'un contact ou la rétention d'un élément supprimé d'une base de données de boîtes aux lettres. |
| Get | Le verbe Get interroge un objet spécifique ou un sous-ensemble d'un type d'objet, tel qu'une boîte aux lettres spécifique, tous les utilisateurs de boîte aux lettres ou les utilisateurs de boîte aux lettres dans un domaine. |
Paramètres importants
Les paramètres suivants vous aident à contrôler le mode d'exécution des commandes et indiquent précisément le résultat produit par une commande avant d'affecter les données.
| Paramètre | Description |
|---|---|
| Identité | Le paramètre Identity identifie l'objet unique pour la tâche. Il est généralement utilisé avec les cmdlets Enable, Disable, Remove, Set et Get. Identity est également un paramètre de position, ce qui signifie qu'il n'est pas nécessaire de spécifier Identity lorsque vous spécifiez la valeur du paramètre dans la ligne de commande. Par exemple, Get-Mailbox -Identity user1 requiert des informations pour la boîte aux lettres de user1. Get-Mailbox user1 équivaut à Get-Mailbox -Identity user1. |
| Whatif | Le paramètre WhatIf donne pour instruction à la cmdlet de simuler les actions qu'elle va appliquer à l'objet. Le paramètre WhatIf permet d'afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $true. |
| Confirmer | Le paramètre Confirm suspend le traitement par la cmdlet et demande à l'administrateur de confirmer les actions que la cmdlet va effectuer avant de continuer le traitement. La valeur par défaut est $true. |
| Valider | Le paramètre Validate amène la cmdlet à vérifier que toutes les conditions préalables à l'exécution de l'opération sont réunies et que l'opération sera exécutée avec succès. |
Conseils et astuces
Les commandes suivantes sont associées à diverses tâches que vous pouvez utiliser dans le cadre de l'administration d'Exchange 2013.
| Applet de commande | Description |
|---|---|
Get-Command |
Cette cmdlet extrait toutes les tâches qui peuvent être exécutées dans Exchange 2013. |
Get-Command *keyword* |
Cette cmdlet extrait les tâches dont la cmdlet contient keyword. |
Get-Task | Get-Member |
Cette applet de commande récupère toutes les propriétés et méthodes de Task. |
Get-Task | Format-List |
Cette cmdlet affiche la sortie de la requête dans une liste mise en forme. Vous pouvez diriger la sortie de n’importe quelle applet de commande Get vers Format-List pour afficher l’ensemble des propriétés qui existent sur l’objet retourné par cette commande, ou vous pouvez spécifier des propriétés individuelles que vous souhaitez afficher, séparées par des virgules, comme dans l’exemple suivant : Get-Mailbox john | Format-List alias,*quota*. |
Help Task |
Cette applet de commande récupère les informations d’aide de l’environnement de ligne de commande Exchange Management Shell pour n’importe quelle tâche dans Exchange 2013, comme dans l’exemple suivant : Help Get-Mailbox. |
Get-Task | Format-List > file.txt |
Cette applet de commande exporte la sortie de Task dans un fichier texte : file.txt |
Autorisations
| Command | Description |
|---|---|
Get-RoleGroupMember "Organization Management" |
Cette commande récupère les membres du groupe de rôles Gestion de l’organisation . |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers |
Cette commande extrait une liste de tous les utilisateurs qui bénéficient des autorisations émanant du rôle de gestion Création de destinataire de message. notamment les utilisateurs membres de groupes de rôles ou de groupes de sécurité universels auxquels ce rôle a été attribué. Les utilisateurs membres de groupes de rôles liés dans une autre forêt ne sont pas concernés. |
Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry |
Cette commande extrait une liste des cmdlets que l’utilisateur doté du rôle Administrateur peut exécuter. |
ForEach ($RoleEntry in Get-ManagementRoleEntry *Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment -Role $RoleEntry.Role -GetEffectiveUsers -Delegating $False | Where-Object {$_.EffectiveUserName -Ne "All Group Members"} | FL Role, EffectiveUserName, AssignmentChain} |
Cette commande extrait une liste de tous les utilisateurs autorisés à exécuter la cmdlet Remove-Mailbox. |
Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain |
Cette commande extrait une liste de tous les utilisateurs autorisés à modifier la boîte aux lettres de l’utilisateur kima. |
New-ManagementScope "Seattle Users" -RecipientRestrictionFilter "City -Eq 'Seattle'" New-RoleGroup "Seattle Admins" -Roles "Mail Recipients", "Mail Recipient Creation", "Mailbox Import Export", -CustomRecipientWriteScope "Seattle Users" |
Cette commande crée une nouvelle étendue de gestion et un groupe de rôles de gestion pour permettre aux membres du groupe de rôles de gérer les destinataires à Seattle. L’étendue de gestion Utilisateurs de Seattle est d’abord créée et correspond uniquement aux destinataires dont l’attribut Ville de leur objet utilisateur contient la valeur Seattle. Ensuite, un nouveau groupe de rôles appelé Administrateurs de Seattle est créé et les rôles Destinataires du courrier, Création de destinataires de courrier et Exportation d’importation de boîte aux lettres sont attribués. L’étendue du groupe de rôles est définie afin que ses membres puissent uniquement gérer les utilisateurs qui correspondent à l’étendue de filtre de destinataire Utilisateurs de Seattle. |
New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -Eq 'Vancouver'" $RoleGroup = Get-RoleGroup "Server Management" <br/><br/> New-RoleGroup "Vancouver Server Management" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Vancouver Servers" |
Cette commande crée une nouvelle étendue de gestion et copie un groupe de rôles existant pour permettre aux membres du nouveau groupe de rôles de gérer uniquement les serveurs du site Active Directory de Vancouver. L’étendue de gestion Serveurs de Vancouver est d’abord créée et correspond uniquement aux serveurs situés sur le site Active Directory de Vancouver. Le site Active Directory est stocké dans l’attribut ServerSite dans les objets serveur. Ensuite, un nouveau groupe de rôles appelé Gestion des serveurs de Vancouver est créé et il s’agit d’une copie du groupe de rôles Gestion du serveur. Toutefois, ce nouveau groupe de rôles est limité pour permettre à ses membres de gérer uniquement les serveurs qui correspondent à l’étendue du filtre de configuration des serveurs vancouver . |
Add-RoleGroupMember "Organization Management" -Member davids |
Cette commande ajoute l’utilisateur davids au groupe de rôles Gestion de l’organisation. |
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" | Remove-ManagementRoleAssignment |
Cette commande supprime le rôle Création de destinataire de message du groupe de rôles Administrateurs de Seattle. Cette commande est très utile puisque nous n’avez pas besoin de connaître le nom de l’attribution de rôle de gestion qui attribue le rôle au groupe de rôles. |
Environnement de ligne de commande Exchange Management Shell distant
| Command | Description |
|---|---|
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos Import-PSSession $Session |
Ces commandes ouvrent une nouvelle session Shell à distance entre un ordinateur local joint à un domaine et un serveur Exchange 2013 distant avec le nom de domaine complet ExServer.contoso.com. Utilisez cette commande pour administrer un serveur Exchange 2013 distant et disposer uniquement de Windows Management Framework (comprenant l'interface de ligne de commande Windows PowerShell) sur l'ordinateur local. Cette commande utilise vos informations d'identification d'ouverture de session actuelles pour l'authentification sur le serveur Exchange 2013 distant. |
$UserCredential = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential Import-PSSession $Session |
Ces commandes ouvrent une nouvelle session Shell à distance entre un ordinateur local joint à un domaine et un serveur Exchange 2013 distant avec le nom de domaine complet ExServer.contoso.com. Utilisez cette commande pour administrer un serveur Exchange 2013 distant et disposer uniquement de Windows Management Framework (comprenant Windows PowerShell) sur l'ordinateur local. Cette commande utilise les informations d'identification d'ouverture de session que vous indiquez de manière explicite pour l'authentification sur le serveur Exchange 2013 distant. |
Remove-PSSession $Session |
Cette commande ferme la session de l'environnement de ligne de commande Exchange Management Shell distant entre un ordinateur local et le serveur Exchange 2013 distant. |
Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([System.IO.File]::ReadAllBytes('M:\AudioFiles\TonySmith.wma')) |
Cette commande montre un exemple de la syntaxe requise pour importer un fichier dans un serveur Exchange 2013 distant à l’aide du paramètre FileData sur une applet de commande. La syntaxe encapsule les données contenues dans le fichier M:\AudioFiles\TonySmith.wma et transfère les données à la propriété FileData de la cmdlet Import-RecipientDataProperty. Le paramètre FileData accepte les données d’un fichier sur votre ordinateur local à l’aide de cette syntaxe sur la plupart des applets de commande. |
$SN = Export-RecipientDataProperty -Identity tonys@contoso.com -SpokenName |
Cette commande montre un exemple de la syntaxe requise pour exporter un fichier à partir d’un serveur Exchange 2013 distant. La syntaxe encapsule les données stockées dans la propriété FileData de l'objet retourné par la cmdlet, puis transfère les données sur votre ordinateur local. Les données sont ensuite stockées dans le fichier C:\tonysmith.wma. La plupart des cmdlets qui génèrent des objets à l'aide d'une propriété FileData utilisent cette syntaxe pour exporter les données dans un fichier sur votre ordinateur local. |