PowerShell を使用して Microsoft 365 ライセンスをユーザーアカウントに割り当てる

[アーティクル]
2024-12-04

この記事は、Microsoft 365 Enterprise および Office 365 Enterprise の両方に適用されます。

ユーザーは、アカウントにライセンスプランからライセンスが割り当てられるまで、Microsoft 365 サービスを使用できません。 PowerShell を使用して、ライセンスのないアカウントにライセンスをすばやく割り当てることができます。

ユーザーアカウントには、まず場所を割り当てる必要があります。場所の指定は、Microsoft 365 管理センターで新しいユーザーアカウントを作成する際に必要な部分です。

オンプレミスの Active Directory Domain Servicesから同期されたアカウントには、既定では場所が指定されていません。これらのアカウントの場所は、次の場所から構成できます。

Microsoft 365 管理センター
PowerShell
Azure portal (Active Directory>ユーザーユーザー> アカウント >プロファイル>連絡先情報>国または地域)。

注:

Microsoft 365 管理センターを使用してユーザーアカウントにライセンスを割り当てる方法について説明します。その他のリソースの一覧については、「ユーザーとグループの管理」を参照してください。

Microsoft Graph PowerShell SDK を使用してユーザーアカウントに Microsoft 365 ライセンスを割り当てる

注:

次のスクリプトでは、Microsoft Graph Powershell を使用します。詳細については、「 Microsoft Graph PowerShell の概要」を参照してください。

無人スクリプトでさまざまな方法を使用して認証 Connect-Graph する方法については、 Microsoft Graph PowerShell の認証モジュールコマンドレットに関する記事を参照してください。

まず、Microsoft 365 テナントに接続します。

ユーザーのライセンスの割り当てと削除には、User.ReadWrite.All アクセス許可スコープ、または「ライセンスの割り当て」 Microsoft Graph API リファレンスページに記載されている他のアクセス許可のいずれかが必要です。

テナントで使用できるライセンスを読み取るために、Organization.Read.All アクセス許可スコープが必要です。

Connect-MgGraph -Scopes User.ReadWrite.All, Organization.Read.All

コマンドをGet-MgSubscribedSku実行して、使用可能なライセンスプランと、organization内の各プランで使用可能なライセンスの数を表示します。各プランで利用可能なライセンスの数は、 ActiveUnits - WarningUnits - ConsumedUnits です。ライセンスプラン、ライセンス、およびサービスの詳細については、「 PowerShell でライセンスとサービスを表示する」を参照してください。

organizationでライセンスのないアカウントを見つけるには、次のコマンドを実行します。

Get-MgUser -Filter 'assignedLicenses/$count eq 0' -ConsistencyLevel eventual -CountVariable unlicensedUserCount -All

organizationでライセンスのない同期ユーザーを見つけるには、次のコマンドを実行します。

Get-MgUser -Filter 'assignedLicenses/$count eq 0 and OnPremisesSyncEnabled eq true' -ConsistencyLevel eventual -CountVariable unlicensedUserCount -All -Select UserPrincipalName

ライセンスは、 UsageLocation プロパティが有効な ISO 3166-1 alpha-2 国コードに設定されているユーザーアカウントにのみ割り当てることができます。たとえば、米国は US、フランスは FR です。一部の Microsoft 365 サービスは、特定の国/地域では利用できません。詳細については、「ライセンス制限について」を参照してください。

UsageLocation 値を持たないアカウントを見つけるには、次のコマンドを実行します。

Get-MgUser -Select Id,DisplayName,Mail,UserPrincipalName,UsageLocation,UserType | where { $_.UsageLocation -eq $null -and $_.UserType -eq 'Member' }

アカウントに UsageLocation 値を設定するには、次のコマンドを実行します。

$userUPN="<user sign-in name (UPN)>"
$userLoc="<ISO 3166-1 alpha-2 country code>"

Update-MgUser -UserId $userUPN -UsageLocation $userLoc

例:

Update-MgUser -UserId "belindan@litwareinc.com" -UsageLocation US

-All パラメーターを使用せずに Get-MgUser コマンドレットを使用すると、最初の 100 個のアカウントのみが返されます。

ユーザーアカウントへのライセンスの割り当て

ユーザーにライセンスを割り当てるには、PowerShell で次のコマンドを使用します。

Set-MgUserLicense -UserId $userUPN -AddLicenses @{SkuId = "<SkuId>"} -RemoveLicenses @()

次の使用例は、SPE_E5 (Microsoft 365 E5) ライセンスプランのライセンスを、ライセンスのないユーザーbelindan@litwareinc.comに割り当てます。

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
Set-MgUserLicense -UserId "belindan@litwareinc.com" -AddLicenses @{SkuId = $e5Sku.SkuId} -RemoveLicenses @()

次の使用例は、SPE_E5 (Microsoft 365 E5) と EMSPREMIUM (ENTERPRISE MOBILITY + SECURITY E5) をユーザーbelindan@litwareinc.comに割り当てます。

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
$e5EmsSku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'EMSPREMIUM'
$addLicenses = @(
    @{SkuId = $e5Sku.SkuId},
    @{SkuId = $e5EmsSku.SkuId}
)

Set-MgUserLicense -UserId "belinda@litwareinc.com" -AddLicenses $addLicenses -RemoveLicenses @()

次の使用例は、MICROSOFTBOOKINGS (Microsoft Bookings) サービスと LOCKBOX_ENTERPRISE (Customer Lockbox) サービスがオフになっているSPE_E5 (Microsoft 365 E5) を割り当てます。

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
$disabledPlans = $e5Sku.ServicePlans | `
    Where ServicePlanName -in ("LOCKBOX_ENTERPRISE", "MICROSOFTBOOKINGS") | `
    Select -ExpandProperty ServicePlanId

$addLicenses = @(
    @{
        SkuId = $e5Sku.SkuId
        DisabledPlans = $disabledPlans
    }
)

Set-MgUserLicense -UserId "belinda@litwareinc.com" -AddLicenses $addLicenses -RemoveLicenses @()

次の使用例は、SPE_E5 (Microsoft 365 E5) を使用してユーザーを更新し、ユーザーの既存の無効なプランを現在の状態のままにしたまま、Swayと Forms サービスプランをオフにします。

$userLicense = Get-MgUserLicenseDetail -UserId "belinda@litwareinc.com"
$userDisabledPlans = $userLicense.ServicePlans | `
    Where ProvisioningStatus -eq "Disabled" | `
    Select -ExpandProperty ServicePlanId

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'
$newDisabledPlans = $e5Sku.ServicePlans | `
    Where ServicePlanName -in ("SWAY", "FORMS_PLAN_E5") | `
    Select -ExpandProperty ServicePlanId

$disabledPlans = ($userDisabledPlans + $newDisabledPlans) | Select -Unique

$addLicenses = @(
    @{
        SkuId = $e5Sku.SkuId
        DisabledPlans = $disabledPlans
    }
)

Set-MgUserLicense -UserId "belinda@litwareinc.com" -AddLicenses $addLicenses -RemoveLicenses @()

$userLicense = Get-MgUserLicenseDetail -UserId belinda@litwareinc.com

$userDisabledPlans = $userLicense.ServicePlans | Where-Object ProvisioningStatus -eq "Disabled" | Select -ExpandProperty ServicePlanId

$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'

$newDisabledPlans = $e5Sku.ServicePlans | Where ServicePlanName -in ("SWAY", "FORMS_PLAN_E5") | Select -ExpandProperty ServicePlanId

$disabledPlans = ($userDisabledPlans + $newDisabledPlans) | Select -Unique

$result=@()
$allPlans = $e5Sku.ServicePlans | Select -ExpandProperty ServicePlanId

foreach($disabledPlan in $disabledPlans)
{
    foreach($allPlan in $allPlans)
    {
        if($disabledPlan -eq $allPlan)
        {
            $property = @{
                Disabled = $disabledPlan
            }
        }
     }
     $result += New-Object psobject -Property $property
}


$finalDisabled = $result | Select-Object -ExpandProperty Disabled


$addLicenses = @(
    @{
        SkuId = $e5Sku.SkuId
        DisabledPlans = $finalDisabled
    }
)


Set-MgUserLicense -UserId belinda@litwareinc.com -AddLicenses $addLicenses -RemoveLicenses @()

別のユーザーからライセンスの割り当てをコピーして、ユーザーにライセンスを割り当てる

この例では、 jamesp@litwareinc.com に適用されているのと同じライセンスプランを belindan@litwareinc.com割り当てます。

$mgUser = Get-MgUser -UserId "belindan@litwareinc.com" -Property AssignedLicenses
Set-MgUserLicense -UserId "jamesp@litwareinc.com" -AddLicenses $mgUser.AssignedLicenses -RemoveLicenses @()

ユーザーを別のサブスクリプション (ライセンスプラン) に移動する

次の使用例は、ユーザーを SPE_E3 (Microsoft 365 E3) ライセンスプランから SPE_E5 (Microsoft 365 E5) ライセンスプランにアップグレードします。

$e3Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E3'
$e5Sku = Get-MgSubscribedSku -All | Where SkuPartNumber -eq 'SPE_E5'

# Unassign E3
Set-MgUserLicense -UserId "belindan@litwareinc.com" -AddLicenses @{} -RemoveLicenses @($e3Sku.SkuId)
# Assign E5
Set-MgUserLicense -UserId "belindan@litwareinc.com" -AddLicenses @{SkuId = $e5Sku.SkuId} -RemoveLicenses @()

このコマンドを使用して、ユーザーアカウントのサブスクリプションの変更を確認できます。

Get-MgUserLicenseDetail -UserId "belindan@litwareinc.com"

次の方法で共有

PowerShell を使用して Microsoft 365 ライセンスをユーザー アカウントに割り当てる

Microsoft Graph PowerShell SDK を使用してユーザー アカウントに Microsoft 365 ライセンスを割り当てる

ユーザー アカウントへのライセンスの割り当て

別のユーザーからライセンスの割り当てをコピーして、ユーザーにライセンスを割り当てる

ユーザーを別のサブスクリプション (ライセンス プラン) に移動する

関連項目

フィードバック

その他のリソース

PowerShell を使用して Microsoft 365 ライセンスをユーザーアカウントに割り当てる

Microsoft Graph PowerShell SDK を使用してユーザーアカウントに Microsoft 365 ライセンスを割り当てる

ユーザーアカウントへのライセンスの割り当て

ユーザーを別のサブスクリプション (ライセンスプラン) に移動する