Como usar o Microsoft 365 PowerShell para gerenciar licenças do Microsoft Planner

  • Artigo
  • Aplica-se a:
    Microsoft 365 Planner

Introdução

Este artigo descreve como usar o Microsoft 365 PowerShell para gerenciar licenças do Microsoft Planner.

Procedimento

O gerenciamento das licenças do Microsoft Planner difere entre a experiência da Primeira Versão e a Disponibilidade Geral (GA). Na Primeira Versão, o Microsoft Planner é uma SKU de nível superior e as licenças não são atribuídas aos usuários por padrão. Enquanto na Disponibilidade Geral, o Microsoft Planner é um serviço disponível sob sua assinatura principal do Microsoft 365, e as licenças serão atribuídas aos usuários por padrão. As seções a seguir abrangem os cenários Primeira versão e Disponibilidade geral. Se você estiver na Primeira Versão e também vir o Microsoft Planner listado em sua assinatura principal do Microsoft 365, use os dois métodos.

Primeiro Lançamento

O Microsoft Planner exige que as licenças sejam atribuídas aos usuários antes que eles possam usar os novos recursos do Planner. Portanto, pode ser mais conveniente usar o Microsoft 365 PowerShell se você tiver muitos usuários na sua organização do Microsoft 365. Este artigo discute os pré-requisitos para usar o Microsoft 365 PowerShell para administrar uma organização do Microsoft 365 e descreve algumas opções para atribuir licenças a todos os usuários, a usuários selecionados com base em metadados e a usuários selecionados com base em uma lista.

Este artigo assume que você já está usando o Microsoft 365 PowerShell para administrar o Microsoft 365. Se você não estiver usando o Microsoft 365 PowerShell, consulte o seguinte site da Microsoft para garantir que você tenha os pré-requisitos para executar os comandos discutidos em Conectar ao Microsoft 365 PowerShell.

Observação

Os módulos Azure AD e MSOnline PowerShell foram preteridos a partir de 30 de março de 2024. Para saber mais, leia a atualização sobre substituição. Após essa data, o suporte para esses módulos é limitado à assistência de migração para o SDK do Microsoft Graph PowerShell e correções de segurança. Os módulos preteridos continuarão funcionando até 30 de março de 2025.

Recomendamos migrar para o Microsoft Graph PowerShell para interagir com o Microsoft Entra ID (anteriormente Azure AD). Para obter respostas para perguntas de migração comuns, consulte as perguntas frequentes sobre migração. Observação: as versões 1.0.x do MSOnline podem sofrer interrupções após 30 de junho de 2024.

O exemplo de comando a seguir pressupõe que você deseja atribuir uma licença a todos os usuários. O cmdlet pode ser salvo e executado como um arquivo .ps1. Ou, você pode executar o script a partir do Ambiente de Script Integrado (ISE) do PowerShell, porque esse é um requisito único.

Connect-MsolService

$licenseObj = Get-MsolAccountSku | Where-Object {$_.SkuPartNumber -eq "PLANNERSTANDALONE"}

$license = $licenseObj.AccountSkuId Get-MSOLUser | Set-MsolUserLicense -AddLicenses $license

A sequência de licença se assemelhará a <Contoso>:PLANNERSTANDALONE. Nesta cadeia de caracteres, o espaço reservado <Contoso> representa o nome da sua organização.

Se pretender atribuir uma licença a um subconjunto de utilizadores com base noutros metadados do registo de utilizador, pode adicionar um filtro Where-Object na última linha do código. Por exemplo, se o campo Departamento for preenchido e você quiser atribuir uma licença somente onde o nome do departamento for "Suporte", poderá usar o seguinte cmdlet:

Get-MSOLUser | Where-Object {$_.department -eq 'Support'} | Set-MsolUserLicense -AddLicenses $license

Se você quiser criar um arquivo que inclua uma lista de usuários e remover dessa lista os nomes dos usuários aos quais não deseja atribuir licenças no momento, use o seguinte cmdlet:

Connect-MsolService

$licenseObj = Get-MsolAccountSku | Where-Object {$_.SkuPartNumber -eq "PLANNERSTANDALONE"}

$license = $licenseObj.AccountSkuId

Get-MsolUser | Select-Object Displayname, UserPrincipalName | `

Export-CSV -Path d:\ExportedUsers.csv -NoTypeInformation

# Edit the file d:\ExportedUsers.csv and remove users who shouldn't be licensed before you run the following command

Import-Csv -Path d:\Exportedusers.csv | ForEach-Object `

{ Set-MsolUserLicense -UserPrincipalName $_.UserPrincipalName -AddLicenses $license}

Se você quiser remover licenças dos usuários, substitua -AddLicenses por -RemoveLicenses em qualquer um desses scripts.

Disponibilidade Geral (GA)

Depois que o Microsoft Planner for GA, as licenças do Microsoft Planner serão listadas em sua assinatura principal do Microsoft 365 ao lado de serviços como Sway, Office Online, Skype e assim por diante (dependendo da sua assinatura). Você já pode ver isso antes do GA se estiver no First Release enquanto nos preparamos para o lançamento do GA.

Por predefinição, a licença do Microsoft Planner será ativada para todos os utilizadores. Você pode usar o PowerShell para desativá-lo, se preferir. Para obter mais informações, consulte Desabilitar o acesso a serviços com o Microsoft 365 PowerShell.

Observação

Nos scripts, o valor DisabledPlans para o Microsoft Planner é PROJECTWORKMANAGEMENT.

Mais informações

Para obter mais informações sobre como usar o Microsoft 365 PowerShell para administrar usuários e licenças no Microsoft 365, consulte os seguintes sites da Microsoft: