Note rapide sur les paramètres positionnels et Office 365
Dernière rubrique modifiée : 2014-06-09
**Résumé :**Utilisez Windows PowerShell pour gérer Office 365 à l'aide des applets de commande, des scripts et des processus de traitement par lots Windows PowerShell.
Les cmdlets Azure Active Directory sont différentes de celles d’Exchange et de Lync Online, du moins en cas d’utilisation de comptes d’utilisateur individuels. Par exemple, avec Lync Online et la cmdlet Get-CsOnlineUser, vous pouvez inclure le paramètre Identity dans votre commande ou vous pouvez l’omettre. En d’autres termes, ces deux commandes fonctionnent et elles renvoient exactement les mêmes informations :
Get-CsOnlineUser -Identity "kenmyer@litwareinc.onmicrosoft.com"
Get-CsOnlineUser "kenmyer@litwareinc.onmicrosoft.com"
Mais ce n’est pas vrai pour les cmdlets Azure Active Directory. Cette commande fonctionne :
Get-MsolUser -UserPrincipalName "kenmyer@litwareinc.onmicrosoft.com"
.gif "Remarque") Remarque : |
|---|
| Nous avons utilisé le paramètre UserPrincipalName ici car la cmdlet Get-MsolUser ne possède pas de paramètre Identity. |
Mais cette commande ne fonctionne pas :
Get-MsolUser "kenmyer@litwareinc.onmicrosoft.com"
Pourquoi ? Sans entrer dans les nombreux détails techniques, la plupart des cmdlets Lync Online et Exchange configurent le paramètre Identity comme un « paramètre positionnel » Cela signifie (dans ce cas tout du moins) que, si vous n’indiquez pas de nom de paramètre (comme -Identity), la cmdlet suppose que le premier paramètre de la commande est le paramètre Identity. Tant que vous démarrez en indiquant l’identité de l’utilisateur, vous pouvez utiliser ou non le paramètre-Identity. Les deux options fonctionnent :
Get-CsOnlineUser -Identity "kenmyer@litwareinc.onmicrosoft.com"
Get-CsOnlineUser "kenmyer@litwareinc.onmicrosoft.com"
Les cmdlets Azure Active Directory ne prennent toutefois pas en charge les paramètres positionnels. Supposons que vous incluiez une valeur sans paramètre d’accompagnement :
Get-MsolUser "kenmyer@litwareinc.onmicrosoft.com"
Dans ce cas, vous obtiendrez un message d’erreur tel que celui-ci :
Get-MsolUser : A positional parameter cannot be found that accepts argument 'kenmyer@litwareinc.onmicrosoft.com'.
Notez également qu’Exchange et Lync Online vous permettent de faire référence aux utilisateurs de plusieurs façons différentes. Par exemple, tous ces commandes Exchange renvoient les mêmes informations de boîte aux lettres :
Get-Mailbox -Identity "Ken Myer"
Get-Mailbox -Identity "kenmyer@litwareinc.onmicrosoft.com"
Get-Mailbox -Identity "kenmyer"
Ces commandes utilisent respectivement le nom d’affichage Active Directory de l’utilisateur, son nom d’utilisateur principal et son alias de messagerie. L’une de ces identités fonctionnera. Mais cela fonctionnera avec Exchange et avec Lync Online. Pour l’essentiel, Azure Active Directory exige que vous utilisiez le nom principal de l’utilisateur et uniquement celui-ci :
Get-MsolUser -UserPrincipalName "kenmyer@litwareinc.onmicrosoft.com"
| Remarque : |
|---|
| Certes, techniquement, vous pouvez utiliser le paramètre ObjectId. Mais pour cela vous devez entrer le GUID (Identificateur global unique) attribué au compte de l’utilisateur. Par exemple : Get-MsolUser –ObjectId "62e90394-69f5-4237-9190-012177145e10" Il vous incombe de décider si vous souhaitez utiliser le paramètre UserPrincipalName ou ObjectId. |
Ceci représente effectivement beaucoup d’informations à assimiler, tout du moins pour un nouvel utilisateur de Windows PowerShell. Si vous êtes novice en matière d’utilisation de Windows PowerShell, vous voudrez peut-être consulter notre article d’introduction sur l’utilisation des paramètres.
À suivre : Utilisation de Windows PowerShell pour gérer SharePoint Online
Voir aussi
Utilisation de Windows Azure Active Directory pour gérer Office 365