Set-MsolUserLicense

ユーザーのライセンス割り当てを更新します。

Note

Set-MsolUserLicense コマンドレットは非推奨です。 Microsoft Graph PowerShell を使用してライセンスを割り当てる方法について説明します。 詳細については、ライセンスの割り当て Microsoft Graph APIを参照してください。

構文

Set-MsolUserLicense
   -ObjectId <Guid>
   [-LicenseOptions <LicenseOption[]>]
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Set-MsolUserLicense
   [-LicenseOptions <LicenseOption[]>]
   -UserPrincipalName <String>
   [-AddLicenses <String[]>]
   [-RemoveLicenses <String[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

説明

Set-MsolUserLicense コマンドレットは、ユーザーのライセンス割り当てを更新します。 新しいライセンスの追加、ライセンスの削除、ライセンス オプションの更新、およびこれらの操作を組み合わせて実行できます。

例 1: ユーザーにライセンスを追加する

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "Contoso:ENTERPRISEPACK"

このコマンドは、Enterprises ライセンスのOffice 365をユーザーに追加します。

例 2: ユーザーからライセンスを削除する

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -RemoveLicenses "contoso:ENTERPRISEPACK"

このコマンドを実行すると、Enterprises ライセンスのOffice 365がユーザーから削除されます。 この結果として、ユーザーのデータが各サービスから削除されることがあります。

例 3: あるライセンスを別のライセンスに置き換える

PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "contoso:DESKLESS" -RemoveLicenses "contoso:ENTERPRISEPACK"

このコマンドは、Enterprises ライセンスのOffice 365を、Office 365 Deskless ライセンスに置き換えます。 これらの変更は、1 回の操作で行われます。 そのため、ユーザーは最終的に中間状態になりません。この中間状態では、Office 365 Deskless が追加されずにエンタープライズライセンスのOffice 365が削除されます。

パラメーター

-AddLicenses

ユーザーに割り当てるライセンスの配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LicenseOptions

ライセンス固有または SKU 固有の設定の配列を指定します。 ライセンスを割り当てるときに個々のサービスを無効にするために使用されます。

Type:LicenseOption[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

ライセンスを更新するユーザーの一意のオブジェクト ID を指定します。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RemoveLicenses

ユーザーから削除するライセンスの配列を指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserPrincipalName

更新するユーザーのユーザー プリンシパル名を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False