Назначение ролей учетным записям пользователей с помощью PowerShell для Office 365Assign roles to user accounts with Office 365 PowerShell

Сводка. Назначайте роли учетным записям пользователей, используя PowerShell для Office 365 и командлет Add-MsolRoleMember.Summary: Use Office 365 PowerShell and the Add-MsolRoleMember cmdlet to assign roles to user accounts.

Вы можете быстро и легко назначать роли с помощью PowerShell для Office 365, указывая отображаемое имя учетной записи пользователя и имя роли.You can quickly and easily assign roles to user accounts using Office 365 PowerShell by identifying the user account's display name and the role name.

Перед началом работыBefore you begin

Чтобы выполнять процедуры, описанные в этой статье, необходимо подключиться к PowerShell в Office 365, используя учетную запись глобального администратора. Инструкции см. в статье Подключение к Office 365 PowerShell.The procedures in this topic require you to connect to Office 365 PowerShell using a global administrator account. For instructions, see Connect to Office 365 PowerShell.

Изменение одной ролиFor a single role change

Определите следующее:Determine the following:

  • Учетная запись пользователя, которую вы хотите настроить.The user account that you want to configure.

    Чтобы указать учетную запись пользователя, необходимо определить ее отображаемое имя. Чтобы получить список учетных записей, используйте эту команду:To specify the user account, you must determine its Display Name. To get a complete list accounts, use this command:

    Get-MsolUser -All | Sort DisplayName | Select DisplayName | More
    

    Эта команда выводит учетные записи пользователей, отсортированное по отображаемому имени, по одному экрану за раз. Вы можете отфильтровать список, используя командлет Where. Вот пример:This command lists the Display Name of your user accounts, sorted by the Display Name, one screen at a time. You can filter the list to a smaller set by using the Where cmdlet. Here is an example:

    Get-MsolUser | Where DisplayName -like "John*" | Sort DisplayName | Select DisplayName | More
    

    Эта команда выводит только учетные записи пользователей, отображаемое имя которых начинается со слова "John".This command lists only the user accounts for which the Display Name starts with "John".

  • Роль, которую вы хотите назначить.The role you want to assign.

    Чтобы отобразить список доступных ролей, используйте эту команду:To display the list of available roles that you can assign to user accounts, use this command:

    Get-MsolRole | Sort Name | Select Name,Description
    

После того как вы определили отображаемое имя учетной записи и имя роли, используйте эти команды, чтобы назначить роль учетной записи:Once you have determined the Display Name of the account and the Name of the role, use these commands to assign the role to the account:

$dispName="<The Display Name of the account>"
$roleName="<The role name you want to assign to the account>"
Add-MsolRoleMember -RoleMemberEmailAddress (Get-MsolUser | Where DisplayName -eq $dispName).UserPrincipalName -RoleName $roleName

Скопируйте команды в Блокнот. Замените описания переменных $dispName и $roleName их значениями, удалите символы < и > и оставьте кавычки. Скопируйте измененные строки в окно модуля Windows Azure Active Directory для Windows PowerShell и запустите их. Кроме того, можно использовать интегрированную среду сценариев Windows PowerShell.Copy the commands and paste them into Notepad. For the $dispName and $roleName variables, replace the description text with their values, remove the < and > characters, and leave the quotes. Copy the modified lines and paste them into your Windows Azure Active Directory Module for Windows PowerShell window to run them. Alternately, you can use the Windows PowerShell Integrated Script Environment (ISE).

Вот пример полного набора команд:Here is an example of a completed command set:

$dispName="Scott Wallace"
$roleName="SharePoint Service Administrator"
Add-MsolRoleMember -RoleMemberEmailAddress (Get-MsolUser | Where DisplayName -eq $dispName).UserPrincipalName -RoleName $roleName

Изменение нескольких ролейFor multiple role changes

Определите следующее:Determine the following:

  • Какие учетные записи пользователей вы хотите настроить.Which user accounts that you want to configure.

    Чтобы указать учетную запись пользователя, необходимо определить ее отображаемое имя. Чтобы получить список учетных записей, используйте эту команду:To specify the user account, you must determine its Display Name. To get a list accounts, use this command:

    Get-MsolUser -All | Sort DisplayName | Select DisplayName | More
    

    Эта команда выводит все учетные записи пользователей, отсортированное по отображаемому имени, по одному экрану за раз. Вы можете отфильтровать список, используя командлет Where. Вот пример:This command lists the Display Name of all your user accounts, sorted by the Display Name, one screen at a time. You can filter the list to a smaller set by using the Where cmdlet. Here is an example:

    Get-MsolUser | Where DisplayName -like "John*" | Sort DisplayName | Select DisplayName | More
    

    Эта команда выводит только учетные записи пользователей, отображаемое имя которых начинается со слова "John".This command lists only the user accounts for which the Display Name starts with "John".

  • Какие роли вы хотите назначить каждой учетной записи пользователя.Which roles you want to assign to each user account.

    Чтобы отобразить список доступных ролей, используйте эту команду:To display the list of available roles that you can assign to user accounts, use this command:

    Get-MsolRole | Sort Name | Select Name,Description
    

После этого создайте текстовый CSV-файл, содержащий поля DisplayName и RoleName. Вот пример:Next, create a comma-separated value (CSV) text file that contains the DisplayName and role Name fields. Here is an example:

DisplayName,RoleName
"Belinda Newman","Billing Administrator"
"John Doe","SharePoint Service Administrator"
"Alice Smithers","Lync Service Administrator"

Затем укажите расположение CSV-файла и запустите получившиеся команды в командной строке PowerShell.Next, fill in the location of the CSV file and run the resulting commands at the PowerShell command prompt.

$fileName="<path and file name of the input CSV file that contains the role changes, example: C:\admin\RoleUpdates.CSV>"
$roleChanges=Import-Csv $fileName | ForEach {Add-MsolRoleMember -RoleMemberEmailAddress (Get-MsolUser | Where DisplayName -eq $_.DisplayName).UserPrincipalName -RoleName $_.RoleName }

См. такжеSee also

Управление учетными записями и лицензиями пользователей с помощью Office 365 PowerShellManage user accounts and licenses with Office 365 PowerShell

Управление Office 365 с помощью PowerShell Office 365Manage Office 365 with Office 365 PowerShell

Начало работы с Office 365 PowerShellGetting started with Office 365 PowerShell

Add-MsolRoleMemberAdd-MsolRoleMember