Set-MsolUserLicense
ユーザーのライセンス割り当てを更新します。
注意
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 |