Azure Active Directory (MSOnline)

Use o Módulo do Azure Active Directory para cmdlets do Windows PowerShell para tarefas administrativas do Azure AD, como gerenciamento de usuários, gerenciamento de domínio e configuração de logon único. Este tópico inclui informações sobre como instalar esses cmdlets para usar com seu diretório.

Observe que começaremos a preterir este módulo quando a funcionalidade deste módulo estiver disponível no módulo mais recente do PowerShell para Graph do Azure Active Directory . Recomendamos que os clientes que estão criando novos scripts do PowerShell usem o módulo mais recente em vez deste módulo.

Instalar o Módulo do Azure AD

O Módulo do Azure AD é suportado nos seguintes sistemas operacionais Windows com a versão padrão do Microsoft .NET Framework e do Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 ou Windows Server 2008 R2.

A maneira mais fácil de instalar o módulo é do Galeria do PowerShell. Você pode instalar o módulo com o cmdlet Install-Module:

Install-Module MSOnline

Módulo de Visualização Pública do MSOnline

A versão de Visualização pública do MSOnline 1.1.130.0 não está mais disponível para download. Se você estiver procurando pelos cmdlets MSOL-Settings para gerenciar configurações de Grupos Unificados, eles estão disponíveis no módulo de Visualização Pública mais recente do Azure AD PowerShell V2, que pode ser encontrado na Galeria do PowerShell para o módulo de Visualização do Azure AD. Você pode instalar este módulo com o cmdlet

Install-Module AzureADPreview

Observe que os cmdlets MSOL Settings receberam um novo nome. Saiba mais sobre esses cmdlets e como usá-los neste artigo.

Importante

Desde 20 de outubro de 2014, o Módulo do Azure Active Directory para Windows PowerShell (versão de 32 bits) foi descontinuado. Não haverá mais suporte para a versão de 32 bits, e as atualizações futuras do Módulo do Azure Active Directory serão lançadas apenas para a versão de 64 bits.

Recomendamos muito que você instale a versão de 64 bits para garantir a continuação da compatibilidade e do suporte.

Você também pode acessar as versões anteriores do módulo do Azure AD no Histórico de lançamento de versões do Módulo do Microsoft Azure Active Directory PowerShell no Wiki do TechNet.

Atualizando o Módulo do Azure AD

Execute o cmdlet Get-Item para verificar a versão dos arquivos DLL do módulo instalado atualmente:

(Get-item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion

Se o número da versão for inferior a 1.0.8070.2, remova a versão existente e reinstale o módulo usando o link na seção anterior. Use Adicionar/Remover Programas no Painel de Controle para remover o Módulo do Active Directory do Azure para Windows PowerShell ou se tiver uma instalação mais antiga, para remover o Módulo do Microsoft Online Services para Windows PowerShell. A desinstalação remove os módulos MSOnline e MSOnlineExtended.

O cmdlet Remove-Module remove os cmdlets MSOnline da sessão, mas não desinstala o módulo.

Conecte-se ao AD do Azure

Antes de executar qualquer um dos cmdlets analisados neste artigo, primeiro você deve conectar seu serviço online. Para fazer isso, execute o cmdlet Connect-MsolService no prompt de comando do Windows PowerShell. Então, serão solicitadas suas credenciais. Se você quiser, poderá fornecer suas credenciais antecipadamente, por exemplo:

$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred

O primeiro comando solicita as credenciais e armazena-as como $Msolcred. O comando seguinte usa essas credenciais como $Msolcred para conectar ao serviço.

Para conectar-se a um ambiente específico do Azure Active Directory, use o parâmetro AzureEnvironment da seguinte maneira:

Connect-MsolService -AzureEnvironment "AzureGermanyCloud"

Este exemplo conecta sua sessão do PowerShell ao ambiente do AzureAD alemão.

Confira Connect-MsolService para saber mais.

Para saber mais sobre os cmdlets, faça o seguinte:

• Para criar uma pasta para obter ajuda, liste os cmdlets e, em seguida, abra o arquivo no bloco de notas, execute os seguintes comandos no prompt de comando do Windows PowerShell:

New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt

• Veja os exemplos de um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Examples

• Exiba o nome, sinopse, descrição, descrições de parâmetro e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Detailed

• Exiba o nome, sinopse, descrição, parâmetros detalhados e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Full

Mais sobre o Windows PowerShell

O Windows PowerShell é um shell da linha de comando baseado em tarefas e uma linguagem de script desenvolvida para administração do sistema. Ao contrário de muitos shells, que aceitam e retornam texto, o Windows PowerShell se baseia no .NET Framework, aceita e retorna objetos do .NET Framework. O Windows PowerShell apresenta o conceito de um cmdlet (pronuncia-se "command-let"), uma ferramenta de linha de comando de função única simples integrada ao shell. Os cmdlets têm a seguinte convenção de nomenclatura: um verbo e um substantivo separados por um traço (-), como Get-Help, Get-Process e Start-Service. O Windows PowerShell inclui mais de 100 cmdlets de núcleo básico. Para obter mais informações sobre o Windows PowerShell, consulte Introdução ao PowerShell do Microsoft Azure (a página pode estar em inglês).