Diagnosticar problemas de conexão com o Conector do Skype for Business Online

Artigo
04/11/2023
Aplica-se a:

Skype for Business

Importante

Skype for Business Online operado pela 21Vianet na China será desativado em 1º de outubro de 2023. Se você ainda não tiver atualizado seus usuários do Skype for Business Online, eles serão agendados automaticamente para uma atualização assistida. Se você quiser atualizar sua organização para o Teams por conta própria, recomendamos que você comece a planejar seu caminho de atualização hoje. Lembre-se de que uma atualização bem-sucedida alinha a preparação técnica e do usuário, portanto, aproveite nossas diretrizes de atualização à medida que você navega até o Teams.

Skype for Business Online, excluindo o serviço operado pela 21Vianet na China, foi desativado em 31 de julho de 2021.

Este artigo fornece informações que ajudam você a diagnosticar e resolve problemas que podem ocorrer quando você tenta criar uma sessão remota do Microsoft PowerShell que se conecta ao Skype for Business Online. Confira as seções a seguir:

Import-Module erro causado pela política de execução Windows PowerShell

A política de execução do PowerShell ajuda a determinar quais arquivos de configuração podem ser carregados no console do PowerShell e quais scripts um usuário pode executar a partir desse console. No mínimo, o módulo Skype for Business Conector Online não pode ser importado a menos que a política de execução tenha sido definida como RemoteSigned. Se não tiver, você receberá a seguinte mensagem de erro ao tentar importar o módulo:

Erro: Import-Module: File C:\Program Files\Common Files\Microsoft Lync Server 2013\Modules\LyncOnlineConnector\LyncOnlineConnectorStartup.psm1 não pode ser carregado porque a execução de scripts está desabilitada neste sistema. Para obter mais informações, consulte about_Execution_Policies em https://go.microsoft.com/fwlink/?LinkID=135170.
Resolução Para resolve esse problema, inicie o PowerShell como administrador e execute o seguinte comando:
```
Set-ExecutionPolicy RemoteSigned
```
Para obter detalhes sobre a política de execução, consulte Sobre políticas de execução.

Import-Module Erro causado pela versão incorreta do Windows PowerShell

O módulo Skype for Business Conector Online só pode ser executado em Windows PowerShell 3.0. Se você tentar importar o módulo em uma versão anterior do PowerShell, o processo de importação falhará com uma mensagem de erro semelhante a esta mensagem:

Erro: Import-Module: a versão do PowerShell carregado é '2.0'. O módulo 'D:\Program Files\Common Files\Microsoft Lync Server 2013\Modules\LyncOnlineConnector\LyncOnlineConnector.psd1' requer uma versão mínima do PowerShell de '3.0' para ser executada. Verifique a instalação do PowerShell e tente novamente.
Resolução: a única maneira de corrigir esse problema é instalar Windows PowerShell 3.0, que está disponível no Centro de Download da Microsoft em https://www.microsoft.com/download/details.aspx?id=34595.

A autenticação moderna falha quando a autenticação do WinRM Basic foi desabilitada

A versão mais recente do módulo Skype for Business Conector Online usa autenticação moderna, mas o cliente do WinRM (Gerenciamento Remoto do Windows) subjacente deve ser configurado para permitir a autenticação básica. A autenticação moderna usa tokens de portador, que geralmente são passados no cabeçalho Autorização: Portador . Windows PowerShell, sobre o qual Skype for Business PowerShell é criado, não permite a manipulação desse cabeçalho. Em vez disso, Skype for Business PowerShell usa o cabeçalho Authorization: Basic para passar o token de portador.

Consulte Baixar e instalar Windows PowerShell para obter instruções sobre como habilitar o WinRM para autenticação básica.

Falha ao se conectar ao Servidor de ID Ao Vivo

Aviso

A autenticação de ID ao vivo foi preterida para o Conector online do Skype For Business. Use o Módulo do Teams PowerShell para gerenciar o locatário online. Ao gerenciar ambientes híbridos, atualize para a atualização cumulativa mais recente ou use a autenticação oAuth.

Normalmente, há três razões pelas quais sua tentativa de conexão pode falhar com a seguinte mensagem de erro:

Erro: Get-CsWebTicket: falha ao conectar servidores de ID ao vivo. Verifique se o proxy está habilitado ou o computador tem conexão de rede com servidores de ID ao vivo.
Resolução: geralmente esse erro significa que o Assistente de Entrada dos Serviços Online da Microsoft não está em execução. Você pode verificar o status desse serviço executando o seguinte comando no prompt do PowerShell:
```
Get-Service "msoidsvc"
```
Se o serviço não estiver em execução, inicie o serviço usando este comando:
```
Start-Service "msoidsvc"
```
Se o serviço estiver em execução, você poderá estar encontrando problemas com a conexão de rede entre o computador e o Servidor de Autenticação de ID Do Microsoft Live. Para marcar isso, abra Explorer da Internet e navegue até https://login.microsoftonline.com/. Tentar fazer logon no Microsoft 365 ou Office 365 a partir daí. Se isso falhar, você provavelmente estará enfrentando problemas de conexão de rede.

Com menos frequência, é possível que o URI de conexão do Microsoft Live ID Authentication Server tenha sido configurado para o valor errado. Se você já determinou que o Assistente de Sign-In está em execução e que você não está enfrentando problemas de conectividade de rede, esse pode ser o problema. Nesse caso, entre em contato com Suporte da Microsoft.

Falha no logon para o usuário

Ao tentar fazer uma conexão remota com Skype for Business Online, você deve fornecer o nome de usuário e a senha de uma conta de usuário válida Skype for Business Online. Se você não fizer isso, o logon falhará junto com uma mensagem de erro semelhante a esta mensagem:

Erro: Get-CsWebTicket: falha no logon para o usuário 'kenmyer@litwareinc.com'. Crie um novo objeto PSCredential, certificando-se de que você tenha usado o nome de usuário e a senha corretos.
Resolução: se você acha que está usando uma conta de usuário válida e que tem a senha correta, tente fazer logon novamente. Se isso falhar, use as mesmas credenciais e tente entrar em https://login.microsoftonline.com/. Se você não conseguir entrar lá, entre em contato com Suporte da Microsoft.

O usuário não tem permissão para gerenciar esse locatário

Você não pode fazer uma conexão remota do PowerShell com oSkype for Business Online, a menos que seja membro do grupo Administradores de Locatários. Se você não estiver, sua tentativa de conexão falhará e você receberá a seguinte mensagem de erro:

Erro: New-PSSession: [admin.vdomain.com] O processamento de dados do servidor remoto admin.vdomain.com falhou com a seguinte mensagem de erro: o usuário 'user@foo.com' não tem permissão para gerenciar esse locatário. As permissões podem ser concedidas atribuindo o usuário à função RBAC apropriada. Para obter mais informações, confira a solução de problemas remotas.
Resolução: se você achar que é ou deveria ser um membro do grupo Administradores de Locatários, precisará entrar em contato com Suporte da Microsoft.

A capacidade de se conectar ao locatário foi desabilitada no Skype for Business Online

Para usar o PowerShell para gerenciar Skype for Business Online, a propriedade EnableRemotePowerShellAccess da política de locatário do PowerShell deve ser definida como True. Se não for, sua conexão falhará e você receberá a seguinte mensagem de erro:

Erro: New-PSSession: [admin.vdomain.com] O processamento de dados do servidor remoto admin.vdomain.com falhou com a seguinte mensagem de erro: A capacidade de se conectar a esse locatário usando uma sessão remota do PowerShell foi desabilitada. Entre em contato com a Ajuda do Lync para marcar Política do Locatário do PowerShell desse locatário. Para obter mais informações, confira a solução de problemas remotas.
Resolução: se você vir essa mensagem de erro, precisará entrar em contato com Suporte da Microsoft e habilitar o acesso remoto do PowerShell.

O número máximo de shells simultâneos para esse usuário no Skype for Business Online foi excedido

Cada administrador tem permissão de no máximo três conexões remotas simultâneas para Skype for Business Online. Se você tiver três conexões remotas do PowerShell em execução, qualquer tentativa de fazer uma quarta conexão simultânea falhará, com a seguinte mensagem de erro:

Erro: New-PSSession: [admin.vdomain.com] A conexão com o servidor remoto admin.vdomain.com falhou com a seguinte mensagem de erro: o serviço WS-Management não pode processar a solicitação. O número máximo de shells simultâneos para esse usuário foi excedido. Feche shells existentes ou aumente a cota para esse usuário. Para obter mais informações, confira a solução de problemas remotas.
Resolução: a única maneira de resolve esse problema é fechar uma ou mais das conexões anteriores. Quando você terminar uma sessão Skype for Business Online, recomendamos usar o cmdlet Remove-PSSession para encerrar a sessão. Isso ajudará você a evitar esse problema.

O número máximo de shells simultâneos para esse locatário no Skype for Business Online foi excedido

Embora cada administrador tenha permissão para ter até três conexões simultâneas com um locatário do Skype for Business Online, nenhum locatário tem permissão para ter mais de 20 conexões simultâneas. Por exemplo, seis administradores podem ter três sessões abertas cada. Se um quarto administrador tentar fazer mais de duas conexões (resultando em um total de 21 conexões simultâneas), essa tentativa falhará, com a seguinte mensagem de erro:

Erro: New-PSSession: [admin.vdomain.com] A conexão com o servidor remoto admin.vdomain.com falhou com a seguinte mensagem de erro: o serviço WS-Management não pode processar a solicitação. O número máximo de shells simultâneos para esse locatário foi excedido. Feche shells existentes ou aumente a cota para esse locatário. Para obter mais informações, confira a solução de problemas remotas.
Resolução: a única maneira de resolve esse problema é fechar uma ou mais das conexões anteriores. Quando você terminar uma sessão Skype for Business Online, recomendamos que você use o cmdlet Remove-PSSession para encerrar essa sessão. Isso ajudará você a evitar esse problema.

Configure seu computador para o gerenciamento online do Skype for Business usando Windows PowerShell.