Установка Microsoft Entra PowerShell

Модуль PowerShell Microsoft Entra позволяет ИТ-специалистам эффективно управлять Microsoft Entra ресурсами, обеспечивая простую интеграцию и функциональность на различных платформах. Этот модуль улучшает возможности автоматизации и оптимизации административных задач.

Из этой статьи вы узнаете, как установить, проверить, обновить и устранить неполадки с модулем PowerShell Microsoft Entra в разных операционных системах.

Модуль PowerShell Microsoft Entra разделен на два модуля, каждый из которых содержит подмодулы, которые можно установить отдельно. Два основных модуля:

  • Microsoft.Entra — версия Microsoft Entra PowerShell, выпущенная в общую доступность, или версия v1.0 Он указывает на ресурсы Microsoft Graph версии 1.0 и Microsoft Graph PowerShell SDK версии 1.0.
  • Microsoft. Entra.Beta — Beta или предварительная версия Microsoft Entra PowerShell. Он указывает на бета-версии Microsoft Graph и на ресурсы бета-версии Microsoft Graph PowerShell SDK.

Для использования с модулем PowerShell версии 7 или выше рекомендуется использовать модуль PowerShell Microsoft Entra на всех платформах, включая Windows, Linux и macOS.

Установка модуля PowerShell Microsoft Entra на Windows

Рекомендуемый метод установки и версия PowerShell для модуля:

Предварительные требования для Windows

  • Выполните следующую команду из PowerShell, чтобы определить версию PowerShell:

    $PSVersionTable.PSVersion

  • Определите, установлен ли модуль:

    Get-Module -Name Microsoft.Entra -ListAvailable

  • Установите политику выполнения PowerShell на удаленно подписанная или менее строгая

    • Проверьте политику выполнения PowerShell:

      Get-ExecutionPolicy -List

    • Установите политику выполнения PowerShell на "удаленная подпись":

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    Дополнительную информацию о политиках выполнения вы можете узнать в разделе about_Execution_Policies.

Installation

При установке модуля можно установить весь модуль или определенный подмодул. В следующих примерах показано, как установить весь модуль для обоих v1.0 и Beta.

Используйте командлет Install-Module для установки модуля.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

При необходимости можно изменить область установки с помощью параметра Scope . Для этой операции требуются разрешения администратора.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Установка определенных вложенных модулей

Установка определенных модулей идеально подходит для сценариев автоматизации, таких как использование Функции Azure и Cлужба автоматизации Azure.

Выполните следующую команду, чтобы перечислить все Microsoft.Entra модули GA/v1.0 в коллекция PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Эта команда выводит список всех модулей Microsoft Entra PowerShell GA/v1.0 в коллекция PowerShell.

Например, чтобы установить Users модуль, выполните следующую команду:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Установка Microsoft Entra PowerShell в Linux

Предварительные требования в Linux

Установка в Linux

При установке модуля можно установить весь модуль или определенный подмодул. В следующем примере показано, как установить весь модуль.

Откройте терминал или другое ведущее приложение оболочки и запустите pwsh , чтобы запустить PowerShell.

Используйте командлет Install-Module для установки модуля:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

При необходимости можно изменить область установки с помощью параметра Scope . Для этой операции требуются разрешения администратора.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Установка определенных подмодул в Linux

Установка определенных модулей идеально подходит для сценариев автоматизации, таких как использование Функции Azure и Cлужба автоматизации Azure.

Выполните следующую команду, чтобы перечислить все Microsoft.Entra модули GA/v1.0 в коллекция PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Эта команда выводит список всех модулей Microsoft Entra PowerShell GA/v1.0, доступных в коллекция PowerShell.

Например, чтобы установить Users модуль, выполните следующую команду:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Установка Microsoft Entra PowerShell в macOS

В этой статье объясняется, как установить модуль из коллекция PowerShell в macOS.

Предварительные требования для macOS

Установка в macOS

При установке модуля можно установить весь модуль или определенный подмодул. В следующем примере показано, как установить весь модуль.

Откройте терминал или другое ведущее приложение оболочки и запустите pwsh , чтобы запустить PowerShell.

Используйте командлет Install-Module для установки модуля PowerShell Microsoft Entra:

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

При необходимости можно изменить область установки с помощью параметра Scope . Для этой операции требуются разрешения администратора.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Установка определенных подмодул в macOS

Установка определенных модулей идеально подходит для сценариев автоматизации, таких как использование Функции Azure и Cлужба автоматизации Azure.

Выполните следующую команду, чтобы перечислить все Microsoft.Entra модули GA/v1.0 в коллекция PowerShell:

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

Эта команда выводит список всех модулей Microsoft Entra PowerShell GA/v1.0 в коллекция PowerShell.

Например, чтобы установить Users модуль, выполните следующую команду:

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Проверка установленной версии и расположения модуля

После завершения установки можно проверить установленные подмодулы, их версию и расположение с помощью следующей команды.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

Эта команда отображает установленный модуль Microsoft Entra PowerShell, его версию и путь установки. Выходная версия должна соответствовать последней версии коллекция PowerShell. Теперь вы готовы использовать модуль.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

Чтобы проверить, установлен ли определенный подмодуль, например Users, выполните команду:

Get-InstalledModule -Name Microsoft.Entra.Users

Выходная версия должна соответствовать последней версии коллекция PowerShell.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

Устранение ошибок установки

Error Причина Обходной путь
Install-Module: не удается найти параметр, соответствующий имени параметра AllowPrerelease. Вы используете старую версию Install-Module. Чтобы обновить, следуйте этому руководству. Проблема относится только к Windows платформе.
Зависимый модуль "имя модуля" не установлен на этом компьютере. Чтобы использовать текущий модуль «Microsoft.Entra», убедитесь, что установлен его зависимый модуль «module-name». Зависимости Microsoft Entra PowerShell не установлены Чтобы установить, используйте этот скрипт
Командлеты уже существуют в системе Добавить -AllowClobber параметр: Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
Следующие команды уже доступны в этой системе: Enable-EntraAzureADAlias, Get-EntraUnsupportedCommand, Test-EntraScript. Возникает конфликт, если уже установлен либо Beta, либо v1.0. Чтобы устранить эту проблему, удалите проблемную версию модуля.

Решения других распространенных проблем установки и других общих проблем см. в разделе "Устранение неполадок при установке модуля".

Войдите в систему.

Чтобы начать управление ресурсами Microsoft Entra с помощью модуля PowerShell Microsoft Entra, запустите сеанс PowerShell и запустите Connect-Entra, чтобы войти в Microsoft Entra ID:

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Используйте учетные данные Microsoft Entra для входа в открывающееся окно входа.

Этот шаг необходимо повторить для каждого запуска нового сеанса PowerShell.

Дополнительные сведения о других сценариях проверки подлинности см. в дополнительных сценариях проверки подлинности.

Обновление модуля

Если модуль установлен, выполните следующие действия, чтобы обновить его.

Сначала проверьте версию модуля и расположение, используя инструкции в разделе проверки установки этой статьи.

Обновление до последней версии

Используйте update-Module для обновления до последней версии модуля PowerShell Microsoft Entra.

Update-Module -Name Microsoft.Entra -Force

Чтобы обновить определенный подмодул, например Users, выполните следующую команду:

Update-Module -Name Microsoft.Entra.Users -Force

Обновление модуля Microsoft Entra PowerShell с использованием Update-Module не удаляет старые версии модуля из вашей системы.

Удалите модуль

Чтобы удалить модуль, выполните команду:

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

Чтобы удалить определенный подмодул, например Users, выполните следующую команду:

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

Чтобы удалить все подмодулы, выполните следующую команду:

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

Дальнейшие действия

  • Last updated on