Set-MsolUserLicense

  • リファレンス
モジュール:
MSOnline

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

注意

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"

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

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

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

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

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

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

このコマンドは、Office 365 for Enterprises ライセンスを Office 365 Deskless ライセンスに置き換えます。 これらの変更は、1 つの操作で行われます。 したがって、ユーザーは、Office 365 Deskless を追加せずに Office 365 for Enterprises ライセンスが削除される中間状態になることはありません。

パラメーター

-AddLicenses

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LicenseOptions

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

型:LicenseOption[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ObjectId

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

型:Guid
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RemoveLicenses

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TenantId

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-UserPrincipalName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False