Подробное изучение командлетов Office 365 PowerShell (часть 4)
- Подробное изучение командлетов Office 365 PowerShell (часть 2)
- Подробное изучение командлетов Office 365 PowerShell (часть 3)
- Подробное изучение командлетов Office 365 PowerShell (часть 6)
Введение
Прежде чем вы сможете запускать какие-либо командлеты Office 365 PowerShell, вам потребуется подключиться к подписке на Office 365. Как указано во второй части этой серии статей, вы можете использовать командлет Connect-MsolService PowerShell. После подключения к подписке на Office 365 вы можете использовать командлеты Office 365 PowerShell для выполнения общих задач. В части 3 мы объяснили некоторые полезные команды Get-MsolUser PowerShell для получения информации о пользователях Office 365.
Командлет и свойства Get-MsolUser
Командлет Get-MsolUser поддерживает ряд свойств пользователя. Помимо использования свойства «IsLicensed», другие свойства, которые я использую в своих повседневных рабочих задачах, описаны в таблице ниже. В приведенной ниже таблице перечислены не все свойства, поддерживаемые командлетом Get-MsolUser, а общие свойства пользователей, которые могут оказаться полезными.
| Имущество | Когда использовать свойство |
| Альтернативные Адреса электронной почты | Отображает дополнительный адрес электронной почты, назначенный пользователю Office 365. |
| Отделение | Как следует из названия свойства. |
| Показать имя | Отображаемое имя пользователя. Это свойство требуется при создании нового пользователя в Office 365. |
| IsLicensed | Возвращает TRUE, если у пользователя есть лицензия на какие-либо планы Office 365, и FALSE, если лицензии нет. |
| Ластдирсинтиме | Если у вас есть пользователи, синхронизированные из локальной службы Active Directory, используйте это свойство, чтобы получить дату и время последней синхронизации. Другими словами, используйте это свойство, если вы используете подход развертывания «Синхронизированное удостоверение» и хотите узнать последний статус синхронизации пользователя. |
| LastPasswordChangeTimestamp | Используйте это свойство, чтобы получить дату и время последнего изменения пароля для пользователей Office 365. |
| LicenseReconciliationNeeded | Независимо от того, есть ли у пользователя в настоящее время почтовый ящик без лицензии Office 365. Я объясню больше об этом свойстве в следующей части этой серии статей. |
| Лицензии | Это многозначное свойство. Он содержит лицензии Office 365, назначенные пользователю. Я объясню больше о свойстве Licenses позже в этой серии статей. |
| LiveId | Это уникальный идентификатор пользователя для входа в Office 365. |
| Мобильный телефон | Как подсказывает название. |
| Общий статус подготовки | Независимо от того, подготовлен ли пользователь для служб Office 365. |
| Пароль никогда не истекает | Используйте это свойство, чтобы узнать, вынужден ли пользователь менять пароль каждые 90 дней. |
| StrongPasswordRequired | Возвращает True или False. True указывает, что пользователь должен установить надежный пароль, когда он изменит свой пароль в следующий раз. |
| ИспользованиеМестоположение | Это двухбуквенный код страны, который необходимо задать для назначения лицензий Office 365. Таким образом, довольно просто понять, что пользователю Office 365 необходимо назначить UsageLocation, прежде чем пользователь сможет использовать службы Office 365. |
| UserPrincipalName | Как подсказывает название. |
| КогдаСоздано | Дата создания пользователя. |
Таблица 1
Кончик:
Вы можете использовать вышеуказанные свойства с командлетом Get-MsolUser и экспортировать выходные данные в файл CSV, добавив «Export-CSV <имя файла CSV> -NoTypeInformation». Однако важно отметить, что при экспорте выходных данных в файл CSV командлет Get-MsolUser экспортирует все свойства пользователя, если вы не укажете имена свойств в команде. Например, выполнение приведенной ниже команды для арендатора Office 365 приведет к экспорту значений всех свойств:
- Get-MsolUser – Все | Export-CSV C:TempOffice365Users.CSV -NoTypeInformation
Возможно, вы не захотите видеть значения всех свойств пользователей Office 365. Чтобы убедиться, что только необходимые свойства экспортируются как часть команды, всегда используйте командлет Select-Object с командлетом Get-MsolUser, как показано в приведенной ниже команде:
- Get-MsolUser <параметры> | Select-Object <Имя свойства, разделенное запятой> | Export-CSV <имя файла CSV> -NoTypeInformation
Например, если вам нужно получить значения для свойств DisplayName, City, UserPrincipalName, IsLicensed, SignInName, вы будете использовать следующую команду PowerShell:
- Get-MsolUser –ALL | Select-Object DisplayName, City, UserPrincipalName, IsLicensed, SignInName | Export-CSV C:TempOffice365Users.CSV -NoTypeInformation
Параметры командлета Get-MsolUser
Командлет Get-MsolUser поддерживает различные параметры, которые можно использовать для получения определенного типа информации для пользователей Office 365. Например, с помощью параметра «-EnabledFilter» вы можете вернуть пользователей, которые включены или отключены. Точно так же вы можете использовать параметр «-HasErrorsOnly», чтобы вернуть пользователей с ошибками проверки. Я составил список параметров Get-MsolUser с примерами в таблице ниже:
Параметр | Когда использовать | Пример |
-EnabledFilter | Используйте параметр –EnabledFilter, чтобы получить список пользователей, которые включены или отключены. Вы можете использовать значения EnabledOnly или DisabledOnly с параметром –EnabledFilter. | Get-MsolUser — All — EnabledFilter DisabledOnly Get-MsolUser –All –EnabledFilter EnabledOnly |
-Доменное имя | Используйте параметр –DomainName, чтобы получить результаты для определенного домена Office 365. | Get-MsolUser –All –DomainName <DomainName> |
-ReturnDeletedUsers | Используйте параметр –ReturnDeletedUsers, чтобы получить список пользователей, которые были удалены из Office 365, но все еще присутствуют в корзине Office 365. | Get-MsolUser – Ретернделетедусерс |
-SearchString | Используйте параметр –SearchString для поиска пользователей в Office 365 Tenant. | Get-MsolUser –All –SearchString Декан Вышеупомянутая команда возвращает только пользователей с адресом электронной почты или отображаемым именем, начинающимся со строки «Dean». |
-Синхронизированный | Используйте параметр –Synchronized, если вам нужно вернуть список пользователей, которые синхронизируются из локальной Active Directory. | Get-MsolUser — Все — Синхронизировано |
-UnlicensedUsersOnly | Используйте –UnlicensedUsersOnly, если вы хотите просмотреть список пользователей, связанных с лицензией Office 365. | Get-MsolUser – All – UnlicensedUsersOnly |
-MaxResults ИЛИ -Все | По умолчанию Get-MsolUser возвращает 500 результатов в команде. Используйте параметр –All, чтобы вернуть все результаты. Вы можете использовать параметр –MaxResults или –All. | Get-MsolUser – All – UnlicensedUsersOnly Get-MsolUser – MaxResults 2000 – UnlicensedUsersOnly |
Таблица 2
Возможно, вы заметили использование параметра «-All» с командлетом Get-MsolUser в приведенных выше примерах. По умолчанию Get-MsolUser возвращает не более 500 результатов в команде. Если вы хотите выполнить операцию Get-MsolUser для всех пользователей Office 365 в арендаторе Office 365, вы должны использовать параметр «-All». Хотя вы можете указать параметр «-MaxResults», но я не вижу никакого использования параметра –MaxResults, если вам нужно выполнять операции Get-MsolUser для всех пользователей Office 365.
Резюме
В этой части мы объяснили свойства пользователя и различные параметры, поддерживаемые командлетом Get-MsolUser. Вы можете использовать описанные выше свойства, чтобы вернуть значение свойства для одного или всех пользователей Office 365.
В следующей части мы расскажем об общих командах Get-MsolUser и о том, как использовать командлет Get-MsolUser с другими командлетами, такими как командлет Get-MsolUserRole.
- Подробное изучение командлетов Office 365 PowerShell (часть 2)
- Подробное изучение командлетов Office 365 PowerShell (часть 6)