Cenários de gerenciamento de usuários do PowerShell do Office 365

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Use estes cenários do PowerShell para adicionar rapidamente contas de usuário provenientes de um arquivo, atribuir licenças, gerenciar associações a grupos de distribuição e definir senhas.

Automatizar a importação de vários usuários

Você pode automatizar a importação de vários usuários para o Office 365 e economizar muito tempo. Para importar um grande número de usuários, é necessário primeiro preparar um arquivo de valores separados por vírgula (CSV) com as informações relevantes dos usuários. As informações mínimas necessárias para criar uma conta de usuário são um Nome para Exibição e um Nome Principal de Utilizador.

O UPN é o nome do usuário em um formato de endereço de email. O nome de usuário (ou "username") é seguido do "símbolo de arroba", e na sequência apresenta-se o nome de domínio da Internet da sua assinatura do Office 365. Um exemplo de UPN é leilag@contoso.com. Você também pode fornecer dados para qualquer propriedade gravável da conta do usuário, como local, números de contato e endereços.

Para as propriedades básicas da conta do usuário, como o UPN e o nome para exibição, prepare um arquivo CSV com os seguintes cabeçalhos de duas colunas:

  • UserPrincipalName,DisplayName

Em seguida, adicione uma nova conta de usuário em cada linha do CSV digitando o UPN e o nome para exibição, separados por vírgula.

Observação : Como você não está especificando uma senha para cada uma das novas contas, o Office 365 vai gerá-las.

Armazene o arquivo CSV em um local que você possa acessar, como em C:\O365Admin\NewUsers.CSV. Agora você já pode criar as contas de usuário.

Para começar, você precisará se conectar ao Office 365 com o Módulo do Windows Azure Active Directory para Windows PowerShell. Confira o artigo Conectar-se ao PowerShell do Office 365 para obter as instruções.

Em seguida, preencha o caminho e o nome do arquivo entre as aspas duplas, removendo o texto de instrução e os caracteres < e >.

$fileName="<path and file name of the CSV file, example C:\O365Admin\NewUsers.CSV>"
Import-Csv $fileName | ForEach { New-MsolUser -UserPrincipalName  $_.UserPrincipalName -DisplayName $_.DisplayName }

Execute os comandos resultantes do Módulo do Windows Azure Active Directory para a janela do Windows PowerShell.

Para mais informações de conta de usuário, prepare o arquivo CSV com os seguintes cabeçalhos de coluna e preencha o maior número de linhas de usuário conforme necessário:

  • UserPrincipalName,DisplayName,FirstName,LastName,Title,Password,UsageLocation,Office,Department,MobilePhone,StreetAddress,City,State,PostalCode,Country

Observação : Os cabeçalhos das colunas não devem conter espaços, pois a referência a cada um deles precisa ser feita pelo elemento $_. do comando Import-Csv. Somente os campos UserPrincipalName e DisplayName são necessários, e os valores em branco serão ignorados. O código UsageLocation é o código ISO de dois caracteres da região do usuário.

Armazene o arquivo CSV em um local que você possa acessar, como em C:\O365Admin\NewUsers.CSV. Agora você já pode importá-las como contas de usuário.

Preencha o nome do arquivo do seu CSV e, em seguida, execute os comandos resultantes.

$fileName="<path and file name of the CSV file, example C:\O365Admin\NewUsers.CSV>"
Import-Csv $fileName | ForEach { New-MsolUser -UserPrincipalName   $_.UserPrincipalName -FirstName $_.FirstName -LastName $_.LastName -DisplayName $_.DisplayName -Title $_.Title -Department $_.Department -Office $_.Office -MobilePhone $_.MobilePhone -StreetAddress $_.StreetAddress -City $_.City -State $_.State -PostalCode $_.PostalCode -Country $_.Country -Password $_.Password }

Atribuir licenças no Office 365

Para que os usuários tenham acesso total ao Office 365, é necessário atribuir-lhes uma licença do Office 365. Neste cenário, você atribuirá licenças às contas de usuário.

Para começar, você precisará se conectar ao Office 365 com o Módulo do Windows Azure Active Directory para Windows PowerShell. Confira o artigo Conectar-se ao PowerShell do Office 365 para obter as instruções.

Antes de atribuir a licença a um usuário, é necessário que você defina o UsageLocation dessa conta com base no código ISO de dois caracteres da região desse usuário. O local de uso especifica o país em que o serviço será usado e determina quais recursos licenciados estão disponíveis nessa região. Por exemplo, US é usado para os Estados Unidos. Veja aqui um exemplo de configuração do local de uso com base em um UPN de uma conta de usuário:

Set-MsolUser -UserPrincipalName user@contoso.com -UsageLocation US

Para exibir a lista de licenças disponíveis, os SKUs das contas e a quantidade restante para atribuição, execute o seguinte comando:

Get-MsolAccountSku

Em seguida, preencha a licença e o UPN da conta do usuário e execute os comandos resultantes do Módulo do Windows Azure Active Directory para a janela do Windows PowerShell.

$license="<the appropriate value of AccountSkuId from the Get-MsolAccountSku command>"
$userUPN="<the UPN of the user account>"
UserLicense -UserPrincipalName $userUPN -AddLicenses $license

Atribuir licenças a vários usuários

No cenário anterior, você atribuiu uma licença a uma única conta de usuário. Atribuir licenças a vários usuários exige mais algumas etapas, mas o tempo gasto será válido se houver um grande número de contas.

Para começar, você precisará se conectar ao Office 365 com o Módulo do Windows Azure Active Directory para Windows PowerShell. Confira o artigo Conectar-se ao PowerShell do Office 365 para obter as instruções.

Em primeiro lugar, exiba a lista de licenças disponíveis, os SKUs das contas e a quantidade restante para atribuição por meio deste comando:

Get-MsolAccountSku

Para exibir a lista de usuários não licenciados, use este comando:

Get-MsolUser -UnlicensedUsersOnly

Para salvar a lista de usuários não licenciados em um arquivo CSV que você poderá usar para escolher contas a fim de atribuir as licenças, preencha o caminho e nome do arquivo e, em seguida, execute os comandos resultantes.

$fileName="<path and file name of the CSV file, example: c:\reports\Unlicensed_Users.CSV>"
Get-MsolUser -UnlicensedUsersOnly | Export-Csv $fileName

Você também pode usar o comando Where para exibir uma lista de contas de usuários não licenciados com base em critérios mais específicos, como aqueles nos Estados Unidos. Veja aqui um exemplo:

Get-MsolUser -All -UnlicensedUsersOnly | Where {$_.Country -eq "United States"}

Use estes comandos para especificar uma propriedade de conta de usuário e seu valor necessário. Exiba um conjunto específico de usuários não licenciados e, em seguida, execute os comandos resultantes:

$userPropertyName="<name of the user property>"
$userPropertyValue="<value of the user property>"
Get-MsolUser -All -UnlicensedUsersOnly | Where {$_.$userPropertyName -eq $userPropertyValue}

Para obter uma lista das propriedades de conta de usuário, preencha qualquer UPN de conta de usuário e execute os comandos resultantes.

$userUPN="<the UPN of any user account>"
Get-MsolUser -UserPrincipalName $userUPN | Select * | More

O exemplo a seguir exibe todos os usuários não licenciados na cidade de Londres:

$userPropertyName="City"
$userPropertyValue="London"
Get-MsolUser -All -UnlicensedUsersOnly | Where {$_.$userPropertyName -eq $userPropertyValue}

Depois de ter identificado o conjunto de contas de usuário, você deverá combiná-lo com o cmdlet Set-MsolUserLicense para atribuir as licenças a cada uma delas. Preencha a licença, o nome da propriedade e seu valor e, em seguida, execute os comandos resultantes.

$license="<the appropriate value of AccountSkuId from the Get-MsolAccountSku command>"
$userPropertyName="<name of the user property>"
$userPropertyValue="<value of the user property>"
Get-MsolUser -All -UnlicensedUsersOnly | Where {$_.$userPropertyName -eq $userPropertyValue}  | Set-MsolUserLicense -AddLicenses $license

Veja aqui um exemplo que atribui a licença E5 do Office 365 da Contoso a todas as contas de usuário não licenciados na cidade de Londres:

$license="contoso:ENTERPRISEPACK"
$userPropertyName="City"
$userPropertyValue="London"
Get-MsolUser -All -UnlicensedUsersOnly | Where {$_.$userPropertyName -eq $userPropertyValue}  | Set-MsolUserLicense -AddLicenses $license

Gerenciar destinatários de grupos de distribuição

Você pode usar grupos de distribuição para criar listas de distribuição de email. Os grupos de distribuição podem ser usados somente com aplicativos de email como o Microsoft Outlook para enviar mensagens de email para grupos de usuários. Neste cenário, você utilizará o PowerShell para gerenciar os destinatários de um grupo de distribuição.

Para começar, você precisará se conectar ao Exchange Online. Para conectar-se ao Exchange Online com um nome de usuário de conta e uma senha, confira o artigo Conectar-se ao PowerShell do Exchange Online. Para instalar o Módulo Remoto do PowerShell do Microsoft Exchange Online e conectar-se com a MFA, confira o artigo Conectar-se ao PowerShell do Exchange Online usando a autenticação multifator.

Para adicionar um destinatário a um grupo de distribuição, preencha o nome do grupo de distribuição e o UPN da conta do usuário e, em seguida, execute os comandos resultantes.

$distName="<name of the distribution group>"
$userUPN="<the UPN of the user account>"
Add-DistributionGroupMember -Identity $distName -Member $userUPN

Para remover um destinatário de um grupo de distribuição, preencha o nome do grupo de distribuição e o UPN da conta do usuário e, em seguida, execute os comandos resultantes.

$distName="<name of the distribution group>"
$userUPN="<the UPN of the user account>"
Remove-DistributionGroupMember -Identity $distName -Member $userUPN

Definir senhas de várias contas de usuário

Use este cenário para definir a senha de um grupo de contas de usuário. Por exemplo, você tem um novo grupo de voluntários que comparecem uma vez por semana para ajudá-lo ou você fornece estações de trabalho de demonstração para uso em conferências.

Uma alteração de senha em massa pode ser útil para redefinir as senhas em contas reutilizáveis regularmente. Ao designar um grupo de usuários por departamento ou outros critérios, é possível redefinir as senhas em massa com base nesses critérios. O primeiro passo é exportar os nomes de contas de usuário do Office 365 para um arquivo CSV.

Para exportar uma lista com base em uma propriedade de conta de usuário e em um valor específico para um arquivo CSV, preencha o nome da propriedade, o valor e o nome do arquivo CSV. Em seguida, execute os comandos resultantes.

$userPropertyName="<name of the user property>"
$userPropertyValue="<value of the user property>"
$fileName="<path and file name of the CSV file, example c:\O365Admin\userlist.csv>"
Get-MsolUser | Where {$_.$userPropertyName -eq $userPropertyValue} | select UserPrincipalName | Export-Csv $fileName -NoTypeInformation

Veja aqui um exemplo que mostra como faz para exportar todos os membros do departamento de voluntários para o arquivo chamado c:\O365admin\volunteerslist.csv:

$userPropertyName="Department"
$userPropertyValue="Volunteers"
$fileName="c:\O365admin\volunteerslist.csv"
Get-MsolUser | Where {$_.$userPropertyName -eq $userPropertyValue} | Select UserPrincipalName | Export-Csv $fileName -NoTypeInformation

Verifique os nomes contidos no arquivo CSV para garantir que você identificou os usuários corretos antes de redefinir as senhas. Depois de obter a lista de usuários validada no formato CSV, há três métodos simples para criar e atribuir uma nova senha a cada usuário.

  1. Especifique uma nova senha e atribua a mesma senha para todos os usuários no arquivo CSV.

    Preencha a nova senha e o nome do arquivo CSV e, em seguida, execute os comandos resultantes.

    $pass="<the new password>"
    $fileName="<path and file name of the CSV file, example c:\O365Admin\userlist.csv>"
    Import-Csv $fileName | ForEach {Set-MsolUserPassword -UserPrincipalName $_.UserPrincipalName -NewPassword $pass -ForceChangePassword $True}
  2. Defina manualmente uma nova senha para cada usuário no arquivo CSV.

    Nesta opção, é necessário modificar o arquivo CSV. Adicione uma coluna ao lado da coluna UserPrincipalName com o título Password e, então, atribua uma senha a todos os usuários da lista. Preencha o nome do arquivo do CSV e, em seguida, execute os comandos resultantes.

    $fileName="<path and file name of the CSV file, example c:\O365Admin\userlist.csv>"
    Import-Csv $fileName | ForEach {Set-MsolUserPassword -UserPrincipalName $_.UserPrincipalName -NewPassword $_.Password -ForceChangePassword $True}
  3. Deixe que o Office 365 gere automaticamente uma senha para cada conta de usuário no arquivo CSV.

    Preencha o nome do arquivo do CSV e, em seguida, execute os comandos resultantes.

    $fileName="<path and file name of the CSV file, example c:\O365Admin\userlist.csv>"
    Import-Csv $fileName | ForEach {[string[]]$a+= $_.UserPrincipalName + "  " + (Set-MsolUserPassword -UserPrincipalName $_.UserPrincipalName -ForceChangePassword $True)} ;$a

Observação : Todas as três opções exigem que o usuário altere a senha na primeira vez que entrar na conta. Para evitar isso, remova -ForceChangePassword $True do comando Set-MSolUserPassword.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Consulte Também

PowerShell para administradores do Office 365

Cenários do PowerShell do Office 365

Cenários de configuração do PowerShell do Office 365

Cenários de relatório do PowerShell do Office 365

Mais cenários de funcionalidade do PowerShell do Office 365

Recursos de comunidade do PowerShell do Office 365

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×