Cenários de configuração 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 conectar-se aos serviços do Office 365, obter ajuda e definir a política de execução de scripts.

Conectar-se aos serviços do Office 365 usando o PowerShell

Para conectar-se aos serviços do Office 365, é preciso primeiro instalar ou importar os módulos mais recentes do PowerShell e, então, criar uma conexão autenticada.

Conectar-se ao Azure Active Directory com o Módulo do Windows Azure Active Directory

Para instalar o Módulo do Windows Azure Active Directory e conectar-se com um nome de usuário de conta e uma senha ou com a autenticação multifator (MFA), confira o artigo Conectar-se ao PowerShell do Office 365.

Conectar-se ao Azure Active Directory com o modulo V2 do Azure Active Directory

Para instalar o módulo V2 do Azure Active Directory e conectar-se com nome de usuário e senha de conta ou com a MFA, confira o artigo Conectar-se com o módulo do PowerShell do Azure Active Directory V2.

Conectar-se 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.

Conectar-se ao SharePoint Online

Para instalar o Shell de Gerenciamento do SharePoint Online e conectar-se com um nome de usuário de conta e uma senha ou com a MFA, confira o artigo Conectar-se ao PowerShell do SharePoint Online.

Conectar-se ao Skype for Business Online

Para conectar-se ao Skype for Business Online com um nome de usuário de conta e uma senha, confira o artigo Conectar-se ao Skype for Business Online usando o Windows PowerShell.

Siga estas etapas para conectar-se ao Skype for Business Online com a MFA:

  1. Para instalar o módulo atual do PowerShell do Skype for Business Online, acesse Skype for Business Online, módulo do Windows PowerShell, clique em Baixar, execute o arquivo baixado e instale-o.

    Você precisa fazer isso apenas uma vez em cada computador de onde está gerenciando o Skype for Business Online.

  2. Abra um prompt de comando do Windows PowerShell.

  3. Preencha o nome da conta entre as aspas duplas, removendo o texto de instrução e os caracteres < e >.

    $acctName="<User Prinicipal Name of an administrator account,  example: belindan@contoso.com>"
    
    #Create a Skype for Business Online session
    $sfboSession = New-CsOnlineSession -UserName $acctName
    
    #Import the Skype for Business session
    Import-PSSession $sfboSession

    Execute os comandos resultantes da janela do Windows PowerShell.

  4. Digite a senha da conta na caixa de diálogo SkypeForBusinessAuth e clique em Entrar.

  5. Siga as instruções na caixa de diálogo SkypeForBusinessAuth para fornecer informações de autenticação adicionais, como o código de verificação e, então, clique em Entrar.

Conectar-se ao Azure Active Directory e ao Exchange Online

Estes comandos do PowerShell farão com que você se conecte ao Azure Active Directory e ao Exchange Online depois de instalar o Módulo do Windows Azure Active Directory.

#Connecting to Exchange Online and Azure Active Directory

#Get administrator account credentials
$credential = Get-Credential

#Connect to Azure Active Directory  
Connect-MsolService -Credential $credential

#Create an Exchange Online session
$ExchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell -Credential $credential -Authentication Basic -AllowRedirection

#Import the Exchange Online session
Import-PSSession $ExchangeSession 

Dica : Para obter este bloco de comando do PowerShell como um arquivo de script (PS1), clique aqui.

Conectar-se a todas as cargas de trabalho do Office 365

Para conectar-se a todas as cargas de trabalho do Office 365 na mesma janela do PowerShell, primeiro é necessário importar ou instalar os módulos relevantes. Este bloco de comando do PowerShell conecta-se ao Azure Active Directory, ao Skype for Business Online, ao SharePoint Online e ao Exchange Online.

Preencha o nome da organização e, em seguida, execute este conjunto de comandos do PowerShell quando estiver se conectando com o nome de usuário e a senha da conta:

#Connect to Office 365 Cloud Services using PowerShell

#Specify your organization name, which is the first part of the name after the "@" character in an account user name. 
#For example, for the account user name belindan@contoso.onmicrosoft.com, the organization name is "contoso".
#Replace everything within the quotes, including the < and > characters, with the correct name. 
$orgName="<organization name>"

#Capture administrative credential for future connections.
$credential = Get-Credential

#Connect to Azure Active Directory.
Connect-MsolService -Credential $credential

#Create a Skype for Business Online session.
$sfboSession = New-CsOnlineSession -Credential $credential

#Import the Skype for Business Online session into your local Windows PowerShell session.
Import-PSSession $sfboSession

#Connect to SharePoint Online.
Connect-SPOService -Url https://$orgName-admin.sharepoint.com

#Create an Exchange Online session.
$ExchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri "https://outlook.office365.com/powershell-liveid/" -Credential $credential -Authentication "Basic" -AllowRedirection

#Imports the Exchange Online session into your local Windows PowerShell session.
Import-PSSession $ExchangeSession

Preencha o nome da organização e, em seguida, execute este conjunto de comandos do PowerShell quando estiver se conectando com a autenticação multifator:

#Specify an account name. 
#Replace everything within the quotes, including the < and > characters, with the correct name. 
$acctName="<User Prinicipal Name of an administrator account,  example: belindan@contoso.com>"

#Extract the organization name from the account name
$orgName= ($acctName).Substring($acctName.IndexOf("@")+1, $acctName.IndexOf(".") - $acctName.IndexOf("@") - 1 )

#Establish Online Services connection to Office 365 Management Layer
Connect-MsolService

#Create Skype for Business session
$sfboSession = New-CsOnlineSession -UserName $acctName

#Import the Skype for Business session command
Import-PSSession $sfboSession

#Connect to your SharePoint Online services.
Connect-SPOService -Url https://$orgName-admin.sharepoint.com

#Create an Exchange Online session.
Connect-EXOPSSession -UserPrincipalName $acctName

Será solicitado, quatro vezes, que você especifique o nome de usuário da conta e a senha e as informações da MFA, como um código de verificação.

Obter ajuda com o PowerShell

Algumas vezes, você pode precisar de ajuda adicional para o PowerShell. Felizmente, o PowerShell possui conteúdo de ajuda interno para orientá-lo.

Exibir os arquivos de ajuda sobre um cmdlet do PowerShell

Para obter mais informações sobre um cmdlet específico, por exemplo Get-Process, execute o seguinte comando.

#Show the help files for a PowerShell command.

Get-Help Get-Process

Exibir o artigo do TechNet sobre o cmdlet do PowerShell

Para abrir a referência de sintaxe online no TechNet de um cmdlet específico, por exemplo Get-Process, execute o seguinte comando.

#Goes online to the TechNet article for the PowerShell cmdlet.

Get-Help Get-Process -Online

Observação : Essa ação requer acesso à Internet para que funcione corretamente.

Exibir exemplos de um comando do PowerShell

Para exibir um exemplo de sintaxe de um cmdlet específico na janela do PowerShell, por exemplo Get-Process, execute o seguinte comando.

#Shows examples for a PowerShell cmdlet.

Get-Help Get-Process -Examples

Atualizar os arquivos de ajuda do PowerShell

O conteúdo de ajuda do PowerShell é atualizado regularmente. Para obter o conteúdo de ajuda mais recente, execute o comando Update-Help. É possível que você veja a seguinte mensagem depois de executar esse comando: "O comando Update-Help baixa os arquivos de ajuda mais recentes dos módulos do Windows PowerShell e instala-os em seu computador." Pressione S para permitir que o módulo atualize os arquivos de ajuda. Esse processo leva apenas alguns minutos para ser concluído.

#Update your PowerShell help files.

Update-Help

Dica : Para obter este bloco de comando do PowerShell como um arquivo de script (PS1), clique aqui.

Configurar a política de execução de script

Os scripts do PowerShell são comandos do PowerShell que são executados em um ou mais arquivos de texto. Os scripts permitem que você automatize tarefas comuns no Windows, em aplicativos da Microsoft e nos serviços do Office 365. Como scripts mal-intencionados podem danificar seu computador ao executar comandos não intencionais, a Microsoft protege você desabilitando os scripts do PowerShell por padrão. Você deve configurar a política de execução do PowerShell de acordo com suas necessidades. As configurações da política de execução são as seguintes:

  • Restricted

    Não carrega arquivos de configuração nem executa scripts. O modo "Restrito", é a política de execução padrão.

  • RemoteSigned

    Exige que todos os scripts e arquivos de configuração baixados da Internet estejam assinados por um fornecedor confiável.

  • AllSigned

    Exige que todos os scripts e arquivos de configuração estejam assinados por um fornecedor confiável, inclusive os scripts que você escreve no computador local.

  • Unrestricted

    Carrega todos os arquivos de configuração e executa todos os scripts. Se você executar um script não assinado que baixou da Internet, será solicitado que você conceda a permissão antes de executá-lo.

  • Bypass

    Nada está bloqueado e não existem avisos ou instruções.

  • Undefined

    Remove a política de execução atribuída no momento do escopo atual. Esse parâmetro não remove a política de execução que é definida em um escopo de Política de Grupo.

Observação : É importante que você apenas baixe e use scripts do PowerShell de uma fonte confiável, principalmente se configurar a política como ‘Unrestricted’ (irrestrita). Por motivos de segurança, também é recomendável reverter todas as alterações feitas para o modo restrito, a menos que você tenha uma necessidade contínua de executar scripts.

O comando Set-ExecutionPolicy só pode ser feito em uma janela do PowerShell aberta usando "Executar como administrador." Também conhecido como uma sessão elevada do PowerShell.

Configurar a política de execução como o modo remoto assinado

Este comando exige que todos os scripts e arquivos de configuração baixados da Internet estejam assinados por um fornecedor confiável. Você pode substituir RemoteSigned pelo seu nome de política de execução desejado para alterar a política aplicada.

#Set execution policies as remote signed.

#This command will display your current execution policy. This is worth noting if you wish to revert back at a later point.
Get-ExecutionPolicy

#This command will set a policy that requires that all scripts and configuration files downloaded from the Internet be signed by a trusted publisher
Set-ExecutionPolicy RemoteSigned

Dica : Para obter este bloco de comando do PowerShell como um arquivo de script (PS1), clique aqui.

Configurar a política de execução como o modo restrito

Este comando define a política de execução como a configuração padrão do PowerShell.

#Setting execution policies as restricted.

#This command will display your current execution policy. This is worth noting if you wish to revert back at a later point.
Get-ExecutionPolicy

#This command will set the execution policy to the default setting for PowerShell 
Set-ExecutionPolicy Restricted

Dica : Para obter este bloco de comando do PowerShell como um arquivo de script (PS1), clique aqui.

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 relatório do PowerShell do Office 365

Cenários de gerenciamento de usuários 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.

×