Set-MsolUserLicense

  • Referência
Módulo:
MSOnline

Atualizações 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 Licença de Atribuição do Microsoft API do Graph.

Syntax

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 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 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 Office 365 para Empresas por uma licença 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 Office 365 para Empresas é removida sem que Office 365 Deskless seja adicionado.

Parâmetros

-AddLicenses

Especifica uma matriz de licenças a serem atribuídas ao usuário.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-ObjectId

Especifica a ID de objeto exclusivo do usuário para o qual atualizar licenças.

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

-RemoveLicenses

Especifica uma matriz de licenças a serem removidas do usuário.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-UserPrincipalName

Especifica o nome principal do usuário a ser atualizado.

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