Référence rapide concernant l’environnement de ligne de commande Exchange Management Shell pour Exchange 2013

Exchange 2013
 

Sapplique à :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.

RemarqueRemarque :
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 :

Les verbes suivants sont pris en charge par la plupart des cmdlets et associés à une action spécifique.

 

New

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 Paramètres importants.

Enable

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 Paramètres importants.

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.

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.

 

Identity

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 est équivalent à 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.

Confirm

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.

Validate

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.

Les commandes suivantes sont associées à diverses tâches que vous pouvez utiliser dans le cadre de l'administration d'Exchange 2013.

 

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 cmdlet extrait 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 transmettre la sortie de la cmdlet Get vers Format-List pour afficher l'ensemble des propriétés qui existent sur l'objet renvoyé par cette commande ou spécifier les propriétés individuelles que vous voulez afficher, séparées par des virgules, comme dans l'exemple suivant : Get-Mailbox *john* | Format-List alias,*quota

Help task

Cette cmdlet extrait des informations de l'aide d'Exchange Management Shell pour toute tâche d'Exchange 2013, comme dans l'exemple suivant : Help Get-Mailbox

Get-task | Format-List > file.txt

Cette cmdlet exporte la sortie de task dans un fichier texte : file.txt

 

Get-RoleGroupMember "Gestion de l’organisation"

Cette commande récupère les membres du groupe de rôles de gestion Gestion de l’organisation.

Get-ManagementRoleAssignment - rôle "Création de destinataire de message" -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 Administrateur | 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 "Utilisateurs de Seattle" -RecipientRestrictionFilter { Ville -Eq "Seattle" }

New-RoleGroup "Administrateurs de Seattle" -Roles "Destinataires de message", "Création de destinataire de message", "Importation/Exportation de boîtes aux lettres", -CustomRecipientWriteScope "Utilisateurs de Seattle"

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.

Un nouveau groupe de rôles appelé Administrateurs de Seattle est ensuite créé et les rôles Destinataires de message, Création de destinataire de message et Importation/Exportation de boîtes 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 "Serveurs de Vancouver" -ServerRestrictionFilter { ServerSite -Eq "Vancouver" }

$RoleGroup = Get-RoleGroup "Gestion des serveurs"

New-RoleGroup "Gestion des serveurs de Vancouver" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Serveurs de Vancouver"

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.

Puis, un nouveau groupe de rôles appelé Gestion des serveurs de Vancouver est créé. Il correspond à une copie du groupe de rôles Gestion des serveurs. L’étendue de ce nouveau groupe de rôles est cependant définie pour permettre à ses membres de gérer uniquement les serveurs correspondant à l’étendue de filtre de configuration Serveurs de Vancouver.

Add-RoleGroupMember "Gestion de l’organisation" -Member davids

Cette commande ajoute l’utilisateur davids au groupe de rôles Gestion de l’organisation.

Get-ManagementRoleAssignment -Role "Création de destinataire de message" -RoleAssignee "Administrateurs de Seattle" | 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.

 

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos

Import-PSSession $Session

Ces commandes ouvrent une nouvelle session de l'environnement de ligne de commande Exchange Management Shell distant entre un ordinateur d'un domaine local 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 de l'environnement de ligne de commande Exchange Management Shell distant entre un ordinateur d'un domaine local 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 ([Byte[]]$(Get-Content -Path "M:\AudioFiles\TonySmith.wma" -Encoding Byte -ReadCount 0))

Cette commande illustre la syntaxe, en italique, requise pour importer un fichier sur un serveur Exchange 2013 distant à l'aide du paramètre FileData d'une cmdlet. 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 provenant d'un fichier sur votre ordinateur local à l'aide de cette syntaxe sur la plupart des cmdlets.

Export-RecipientDataProperty -Identity tony@contoso.com -SpokenName | ForEach { $_.FileData | Add-Content C:\tonysmith.wma -Encoding Byte}

Cette commande illustre un exemple de la syntaxe, en italique, 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.

 
Afficher: