Partilhar via

Azure Active Directory (MSOnline)

  • Artigo

Importante

Os módulos do Azure AD e do MSOnline PowerShell são preteridos a partir de 30 de março de 2024. Para saber mais, leia a atualização de preterição. Após esta data, o suporte para estes módulos está limitado à assistência de migração para o SDK do PowerShell do Microsoft Graph e correções de segurança. Os módulos preteridos continuarão a funcionar 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 perguntas comuns sobre migração, veja as FAQ sobre Migração. Nota: As versões 1.0.x do MSOnline podem sofrer interrupções após 30 de junho de 2024.

Pode utilizar cmdlets MSOnline para tarefas administrativas do Azure AD, como gestão de utilizadores, gestão de domínios e para configurar o início de sessão único. Este tópico inclui informações sobre como instalar estes cmdlets para utilização no seu diretório.

Instalar o MSOnline

O módulo MSOnline é suportado nos seguintes sistemas operativos Windows com a versão predefinida 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.

Pode instalar este módulo a partir da Galeria do PowerShell.

Ligar ao Azure AD

Para poder executar qualquer um dos cmdlets referidos neste artigo, primeiro tem de ligar ao seu serviço online. Para tal, execute o cmdlet Connect-MsolService na linha de comandos do Windows PowerShell. Em seguida, ser-lhe-ão pedidas as suas credenciais. Se pretender, pode fornecer as suas credenciais antecipadamente, por exemplo:

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

O primeiro comando pede as credenciais e armazena-as como $Msolcred. O comando seguinte utiliza essas credenciais como $Msolcred para ligar ao serviço.

Para ligar a um ambiente específico do Azure Active Directory, utilize o parâmetro AzureEnvironment, da seguinte forma:

Connect-MsolService -AzureEnvironment "AzureGermanyCloud"

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

Veja Connect-MsolService para obter mais informações.

Para obter mais informações sobre os cmdlets, pode fazer o seguinte:

  • Para criar uma pasta para obter ajuda, listar os cmdlets e, em seguida, abrir o ficheiro no bloco de notas, pode executar os seguintes comandos na linha de comandos 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

  • Para ver os exemplos de um cmdlet, execute o seguinte comando na linha de comandos do Windows PowerShell: Get-Help <cmdlet-name> -Examples

  • Para ver o nome, a sinopse, a descrição, as descrições dos parâmetros e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando na linha de comandos do Windows PowerShell: Get-Help <cmdlet-name> -Detailed

  • Para ver o nome, a sinopse, a descrição, os parâmetros detalhados e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando na linha de comandos do Windows PowerShell: Get-Help <cmdlet-name> -Full

Nota

O MSOnline PowerShell só pode ser utilizado por utilizadores que sejam membros do diretório. Os utilizadores convidados não podem utilizar o MSOnline PowerShell.

Mais sobre o Windows PowerShell

O Windows PowerShell é uma shell de linha de comandos e linguagem de script baseada em tarefas concebida para a administração de sistemas. Ao contrário da maioria das shells, que aceitam e devolvem texto, o Windows PowerShell é desenvolvido com base no .NET Framework e aceita e devolve objetos do .NET Framework.

O Windows PowerShell apresenta o conceito de cmdlet (pronunciado "command-let"), uma ferramenta de linha de comandos simples com uma função única incorporada na shell.

Os cmdlets têm a seguinte convenção de nomenclatura: um verbo e um nome separados por um travessão (-), tal como Get-Help, Get-Process e Start-Service.

O Windows PowerShell inclui mais de cem cmdlets de núcleo básico. Para obter mais informações sobre o Windows PowerShell, veja a Introdução ao Windows PowerShell.