Set-MsolUserLicense
Atualiza a atribuição de licença para um usuário.
Observação
O cmdlet Set-MsolUserLicense foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a API Atribuir Licença do Microsoft Graph.
Sintaxe
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>] Description
O cmdlet Set-MsolUserLicense atualiza a atribuição de licença para um usuário. Isto pode incluir o acréscimo de uma nova licença, a remoção de uma licença, a atualização das opções de licenças ou qualquer combinação dessas ações.
Exemplos
Exemplo 1: Adicionar uma licença a um usuário
PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "Contoso:ENTERPRISEPACK"Esse comando adiciona a licença do Office 365 para Empresas ao usuário.
Exemplo 2: remover uma licença de um usuário
PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -RemoveLicenses "contoso:ENTERPRISEPACK"Esse comando remove a licença do Office 365 para Empresas do usuário. Isto pode resultar nos dados do usuário sendo removidos de cada serviço.
Exemplo 3: substituir uma licença por outra
PS C:\> Set-MsolUserLicense -UserPrincipalName "davidchew@contoso.com" -AddLicenses "contoso:DESKLESS" -RemoveLicenses "contoso:ENTERPRISEPACK"Esse comando substitui a licença do Office 365 para Empresas por uma licença do Office 365 Deskless. Essas alterações são feitas em uma única operação. Portanto, o usuário não acaba em um estado intermediário em que a licença do Office 365 para Empresas é removida sem que o Office 365 Deskless seja adicionado.
Parâmetros
-AddLicenses
Especifica uma matriz de licenças a serem atribuídas ao usuário.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LicenseOptions
Especifica uma matriz de configurações específicas de licença ou SKU. Usado para desabilitar serviços individuais ao atribuir uma licença.
| Tipo: | LicenseOption[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ObjectId
Especifica a ID de objeto exclusiva do usuário para o qual as licenças serão atualizadas.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-RemoveLicenses
Especifica uma matriz de licenças a serem removidas do usuário.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-TenantId
Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-UserPrincipalName
Especifica o nome principal do usuário a ser atualizado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |