Partilhar via


FAQ da ferramenta de migração do Stream

Este artigo resume as perguntas mais frequentes sobre Stream ferramenta de migração.

Não vejo todos os meus vídeos Stream (Clássico) na ferramenta de migração.

Não vejo todo o meu vídeo Stream (Clássico) no relatório de inventário.

Não, todos os vídeos no Stream (Clássico) devem estar visíveis no relatório de inventário. Pesquisa o relatório através de Stream ID de vídeo. Pode encontrar este ID no final do URL de reprodução de vídeo, por exemplo, https://web.microsoftstream.com/video/videoid

A ferramenta de migração mostra menos vídeos no meu grupo ou canal da empresa do Microsoft 365 do que os vídeos que vejo no Stream (Clássico).

Qual é a velocidade ou o débito da ferramenta de migração?

O que acontece aos meus vídeos órfãos hoje?

Órfãos são vídeos sem proprietário atualmente e o carregador original saiu da organização. Desde julho de 2023 que a ferramenta de migração tem a funcionalidade de as migrar. Leia a secção de vídeos órfãos para obter mais detalhes.

Vejo alguns vídeos não elegíveis no relatório de inventário, o que são?

Os vídeos que não são publicados (no estado de rascunho) ou eliminados (na reciclagem) não são elegíveis para migração. Não serão migrados pela ferramenta. Os utilizadores finais podem publicar esses vídeos ou os administradores podem restaurar o vídeo a partir da reciclagem, para que a ferramenta de migração os possa escolher.

Não consigo ver alguns dos meus sites do SharePoint ao atribuir destinos na IU para um único contentor.

Se os sites SP ou Teams no seu inquilino não estiverem visíveis na IU, ao atribuir destinos, poderão existir alguns motivos para tal.

  • Por predefinição, os administradores do SP não têm acesso aos sites onde não são o proprietário ou os membros, embora possam adicionar-se ao grupo ou equipa. Assim, apenas os sites são visíveis em que o administrador é, pelo menos, um membro do grupo ou equipa. Isto deve-se ao facto de os sites serem pesquisados através do token delegado no âmbito do utilizador. No entanto, esses sites são detetados durante o mapeamento automático do destino, uma vez que utilizamos o token baseado na aplicação
  • Os administradores também podem não ver sites para um inquilino multigeográfico, uma vez que a graph API utilizada para obter os sites não pode fazê-lo de forma fiável em alguns casos de canto.
  • Num caso de canto, se o site for criado recentemente, poderá demorar algum tempo a sincronizar e a aparecer na IU. O ETA é de algumas horas. Nota: em alguns cenários de canto (por exemplo: carateres especiais no caminho de destino), a pesquisa de sites SP na IU pode não funcionar. Nestes casos, pode atribuir o destino manualmente através do carregamento csv com a opção "Carregar destino" na ferramenta de migração.

O destino para alguns contentores de grupos do Microsoft 365 e utilizadores não é atribuído automaticamente.

Se o contentor tiver sido adicionado ao separador análises através de "Adicionar contentores –> Procurar novos contentores no Stream", o destino de todos os grupos e contentores de utilizadores do Microsoft 365 é automaticamente atribuído com base no melhor esforço. Para os destinos em que o destino não foi atribuído automaticamente, o mesmo pode ser feito através do carregamento csv com a opção "Carregar destino" na ferramenta de migração. Também pode utilizar o script mencionado na nota aqui para identificar destinos de grupos do Microsoft 365 e carregá-los através da opção "Carregar Destino".

Posso remover a opção para carregar para Stream (no SharePoint) para os utilizadores finais da minha organização?

Infelizmente, não é possível agora. Alterámos a página de carregamento clássica e demos uma exceção aos clientes para a prolongarem, que o período de extensão também expirou agora. Veja o item de linha de 17 de janeiro de 2023 na linha cronológica de migração e publicação mc MC496849 publicado a 12 de janeiro de 2023.

Os meus vídeos continuam visíveis no Stream Clássico depois de os ter migrado.

Existe um código de back-end que é executado para ocultar ou eliminar de forma recuperável os vídeos de Stream (Clássico) após a migração. Pode demorar até dois dias para ocultar o conteúdo. Devido a um erro, os vídeos migrados antes de 15 de agosto de 2023 ainda podem estar visíveis na IU do Stream (Clássico). Para resolver este problema, pode remigrar os vídeos afetados.

Devo fazer uma cópia de segurança do meu vídeo Stream (Clássico) antes da migração, caso algo de mau aconteça?

Absolutamente Não. Recomendamos que execute primeiro as migrações de teste para compreender as permissões, a localização e os metadados nos vídeos migrados. Publique que deve executar uma migração piloto com alguns vídeos de produção. Dá-lhe confiança, não coloca todos os dados em risco e minimiza as hipóteses de erro.
Além disso, após a migração, ocultamos ou eliminamos de forma recuperável os vídeos de Stream (Clássico), mas não eliminamos duramente até Stream (Clássico) descontinuação da infraestrutura. Durante o processo, para casos críticos, podemos mostrar os dados no Stream (Clássico).

Existem vídeos comunicados como "inelegíveis" a serem migrados – como podemos resolver estes casos?

Os vídeos não elegíveis são mencionados aqui na nossa documentação. Pode dever-se ao facto de os vídeos estarem com erros de estado ou rascunho ou eliminados. Pode restaurar os vídeos eliminados a partir da reciclagem e publicar vídeos em rascunho.

Que permissões são necessárias para executar uma Migração de Stream?

Stream Ferramenta de migração localizada no Gestor de migração apresenta o erro "O serviço não está disponível. Contactar o suporte"

Podem estar bloqueados devido a URLs necessários que teriam de ser permitidos para a ferramenta se ligar ou um problema de ligação de rede. Poderá ter de adicionar os seguintes URLs à lista de permissões:

  • https://api.mover.io
  • https://api.microsoftstream.com/

Além disso, se for um inquilino GCC, adicione também o seguinte URL à lista de permissões:

  • https://api.prod.migrations.microsoft.com

Se continuar a ter problemas de ligação, verifique se a Aplicação Mover está ativada e se os inícios de sessão também estão ativados. Siga os seguintes passos:

Podemos reverter a migração de vídeos de Stream (Clássico) para Stream (no SharePoint)?

É uma migração flexível onde os administradores optam por migrar os vídeos de que precisam. É recomendado executar a ferramenta com alguns vídeos de teste e testar algumas migrações com alguns vídeos de Produção. Assim, a necessidade de reversão pode ser menor. No entanto, por um motivo comercial válido, podemos mostrar o conteúdo que foi migrado do Clássico. Neste processo, as alterações efetuadas em vídeos migrados no Stream (no SharePoint) não serão apresentadas em vídeos que reaparecem no clássico. Tem de submeter o pedido através deste formulário e partilhar os mesmos detalhes através de um pedido de suporte. O ETA para reversão está a três dias úteis da submissão das informações através do formulário.

Como é que os meus utilizadores finais podem detetar conteúdo migrado?

Espelhamos as permissões quando os vídeos migram de Stream (Clássico) para Stream (no SharePoint). Cada utilizador que tenha acesso a um vídeo é Stream (Clássico) retém o acesso ao vídeo migrado. Os utilizadores finais podem encontrar o vídeo através da pesquisa no Stream (no SharePoint) se o vídeo tiver migrado ou Stream (clássico) para um vídeo não migrado. Até ao final de 23 de março, os administradores recebem um relatório que lhes dá a localização de destino de cada ficheiro de vídeo migrado. Está disponível no relatório de inventário.

Posso aplicar políticas de retenção ou expiração no Stream (Clássico) durante a migração de vídeos?

Não, a política de retenção ou expiração já existiu no Stream (Clássico), pelo que essa política não é aplicada durante a migração de vídeos. No entanto, é teoricamente possível aplicar a expiração aos vídeos depois de serem migrados para Stream (no SharePoint). Definimos uma variável (mediaitem.progID) para identificar um vídeo migrado.

Por que motivo vejo a data/hora anexada ao nome do ficheiro de vídeo após a migração?

Dois vídeos no Stream (Clássico) podem ter os mesmos nomes de ficheiro, no entanto, isso não é possível no One Drive & SharePoint. Dois ficheiros com o mesmo nome no SharePoint são considerados versões. Anexamos a data/hora para evitar que isto aconteça. No entanto, o título do vídeo, visível durante a reprodução, não é alterado na migração.

Os meus vídeos são copiados ou movidos durante a migração? Estão disponíveis no Stream Clássico depois de migrarem?

Fazemos uma cópia do vídeo e carregamo-lo para o SharePoint ou OneDrive. Ao mesmo tempo, ocultamos ou eliminamos de forma recuperável o vídeo de Stream (Clássico) depois de ser migrado. Iremos eliminar o vídeo quando Stream (Clássico) infra-falha for preterida. Os vídeos anteriores foram eliminados 180 dias após a migração, mas alterámos isto a partir de meados de junho.

Como posso resolver erros ou vídeos falhados?

Veja os códigos de erro e a definição fornecidos pela plataforma.

A ferramenta de migração Stream volta a tentar vídeos com falhas? Devo tentar novamente?

Sim, existem repetições incorporadas na ferramenta de migração. No entanto, após muito tempo, se os vídeos continuarem a ser apresentados falharam por um motivo de erro não devido a algum problema no seu lado, poderá tentar novamente novamente. Se continuar a falhar, crie um pedido de suporte

Os vídeos migrados estão visíveis na página Início no office.com?

Não, a migração por si só não fará com que o vídeo apareça na página inicial no office.com. No entanto, se um vídeo tiver sido acedido por um utilizador depois de ter sido migrado, ficará visível no separador "recentes" na página inicial.

O que acontece quando a reprodução ou o redirecionamento do suporte para vídeos migrados antigos Stream (Clássico) terminam?

Posso contratar mais ajuda para mudar para Stream (no SharePoint)?

Se quiser contratar um parceiro de terceiros para ajudá-lo com a sua migração ou ajudá-lo a começar a utilizar Stream (no SharePoint) recolhemos esta lista de parceiros que se identificaram como tendo esta experiência. Veja a lista de parceiros de terceiros para obter mais detalhes.

Como definimos vídeos órfãos? O vídeo é qualificado como órfão se o carregador tiver saído da organização?

Quando movemos vídeos, certificamo-nos de que o atribuímos a alguém na sua organização. Se um vídeo não tiver nenhum grupo do Microsoft 365 ou Utilizador atribuído como proprietário ou não estiver associado a um canal da empresa, marcamos o vídeo como órfão. Um vídeo órfão move-se como parte do contentor "vídeos órfãos" (ETA: Junho). A sua organização pode ter vários contentores de vídeo órfãos, dependendo do número desses vídeos no seu inquilino. Podem existir alguns vídeos em que o carregador deixou a organização, mas ainda não são classificados como órfãos, uma vez que têm um proprietário de grupo do Utilizador ou do Microsoft 365 ou estão associados a um canal da empresa. Neste caso, o vídeo migra com o contentor correspondente e não com o contentor de vídeo órfão.

Por que interrompemos a herança na pasta de destino durante a migração de permissões?

Como identificar contentores com detalhes de vídeo e vídeo sobrepostos.

Posso mover o vídeo de um contentor para duas localizações diferentes?

Não promovemos a migração de vídeos num contentor para localizações diferentes. No entanto, existe uma solução. Pode fazê-lo através de filtros de migração parciais. Migrar um conjunto de vídeos para a primeira localização através de filtros. Elimine o contentor do separador Migrações depois de migrar com êxito. Adicione o mesmo contentor com um novo conjunto de filtros e migre para uma nova localização. No entanto, só pode dividir os vídeos com base nos filtros de vídeo disponíveis. Além disso, o redirecionamento do URL do grupo aponta para a última localização de destino do grupo migrado.

Por que motivo não consigo adicionar manualmente mais contentores?

A ferramenta de migração tem um limite de 50 000 contentores de cada vez. Se adicionou inadvertidamente mais de 50 000 contentores, terá de remover alguns contentores para que a contagem total de contentores, após as adições manuais, permaneça abaixo deste limiar.

Como devo proceder para corresponder dados entre Stream (Clássico) portal, o relatório de inventário e a ferramenta de migração?

Existem três origens de dados; Stream (Clássico) portal - Vamos chamá-lo de A, Relatório de Inventário (ou dashboard do Power BI)- Vamos chamá-lo de ferramenta B e Migração - Vamos chamá-lo de C

  1. Um & B deve corresponder perfeitamente. Pode localizar todo o seu vídeo no relatório de inventário. Pesquisa para um vídeo através do ID de vídeo no relatório. Pode encontrar este ID no final do URL de reprodução de vídeo, por exemplo, https://web.microsoftstream.com/video/videoid
  2. B & C agora também corresponderão. Anteriormente, devido à falta de suporte para vídeos órfãos na ferramenta de migração (C), B e C não corresponderiam.
  3. Um & C não corresponde porque os vídeos podem não aparecer no mesmo local na ferramenta que aparecem no Stream (Clássico) porque a ferramenta move vídeos em grupos lógicos ou contentores. Stream (Clássico) vídeos associados a grupos do Microsoft 365, canal da empresa ou grupo de Stream movem-se sempre em conjunto e não se movem com o contentor do Utilizador que carregou os vídeos. Seguimos a ordem de prioridade: Stream grupo > Microsoft 365 grupo Utilizador de canal > de toda a empresa>. Veja os casos de permissões para obter mais informações. Assim, poderá ver o vídeo de um carregador a mover-se no grupo do Microsoft 365 e, portanto, poderá não estar visível no contentor de utilizadores do Uploader da ferramenta de migração.

Vejo o erro MUSERNOTFOUND numa migração de contentor de utilizador.

Se o Stream Clássico estiver desativado e o utilizador for eliminado ou num estado inativo, a migração do contentor do utilizador poderá falhar com o erro MUSERNOTFOUND no Relatório de registo de migração. Existe uma solução. Considere alterar o caminho de destino predefinido para uma localização válida para uma migração bem-sucedida do conteúdo do utilizador. Se Stream Clássico estiver ativado e o utilizador estiver num estado inativo, "Procurar Novos Contentores" para obter os vídeos deste utilizador. O contentor de utilizador já adicionado para este utilizador não migra o conteúdo do utilizador.

Falha ao executar o script de automatização, o script de relatório de inventário e o script de permissão se o nome da pasta tiver a chave de espaço.

Para escapar a espaços num caminho de ficheiro do Windows, coloque aspas duplas à volta da secção do caminho com um espaço. Por exemplo: C:"Test Folder"\text.txt. Também pode colocar aspas em todo o caminho para garantir que não perde espaços.

Como obter uma lista de todos os contentores de grupo do Microsoft 365 e CWC no ambiente de inquilino?

O relatório de inventário fornece uma lista de todos os IDs de contentor aos quais é atribuído pelo menos um vídeo. É possível que o seu inquilino tenha alguns grupos do Microsoft 365 e CWC em que os vídeos aparecem na IU Stream (Clássico), mas nenhum lhes foi atribuído de acordo com a hierarquia de atribuição, pelo que esses contentores com zero vídeos não são apresentados no relatório de inventário. A adição mais recente ao script de inventário traz um parâmetro adicional chamado "GenerateMasterContainerList" que, quando explicitamente definido como verdadeiro (o seu valor é falso por def), gera uma lista de todos os M365Groups e CompanyWideChannels disponíveis no seu inquilino num ficheiro separado.

  1. Para executar o script, o utilizador tem de seguir os passos antigos para executar o script de inventário, sendo que o único passo adicionado é que o parâmetro "GenerateMasterContainerList" tem de ser adicionado com o respetivo valor definido como verdadeiro.
  2. Comando de exemplo para executar o script: .\StreamClassicVideoReportGenerator.ps1 -AadTenantId "000000000-0000-0000-00000000000000" -InputFile "C:\Users\Username\Desktop\token.txt" -OutDir "C:\Users\Username\Desktop" -GenerateMasterContainerList true
  3. O valor deste parâmetro é falso por predefinição.
  4. Suporta Retomar exatamente da mesma forma que o script antigo. Uma vez que alguns inquilinos podem ter um grande número dessas entidades, o script pode terminar durante a execução devido à expiração do token de autenticação. Nesse evento, o utilizador tem de substituir o token antigo pelo novo token no ficheiro de token e reiniciar o script. Por predefinição, o script é executado com o sinalizador Retomar definido como verdadeiro, pelo que o script será novamente apanhado na última execução. Se existir um grande número de entidades, o resultado está presente em vários csv, uma vez que cada csv de saída foi concebido para não ter mais de 10 000 linhas.
  5. A lista final que contém todos os ficheiros intercalados pode ser encontrada na pasta \Out\report.

Como devo proceder para extrair os vídeos disponíveis em cada canal no Stream (Clássico)?

Os clientes precisam de criar o seu próprio script para obter estas informações de mapeamento. Estamos a fornecer um script que foi partilhado connosco, pode utilizá-los com base na sua discrição. Nota: este script não é suportado pela Microsoft.

Script 1:

#Token file Path
$tokenInputFile="C:\temp\StreamReportGenerator\token.txt" 
#Please Note the Base Url - https://uswc-1.api.microsoftstream.com/api/ needs to be replaced by Base Url of your tenant using script 2 
$baseURI = "https://uswc-1.api.microsoftstream.com/api/" 
#ChannelVideoReport Path – Please replace it with path to csv file where we want to export the channel video report data 
$channelVideoReportPath =  "C:\temp\StreamReportGenerator\channelVideosReport.csv" 
$getAllChannelsUri= $baseURI + "channels?`$top=100&`$skip=0&`$orderby=created desc&`$expand=creator,group&adminmode=true&api-version=1.4-private"
$token = Get-Content -Path $tokenInputFile 
$headers = @{ 
    "Accept" = "application/json, text/plain, */*" 
    "Authorization" = "Bearer $($token)" 
} 
$ChannelVideoInfoCollection=@() 
$response = Invoke-RestMethod -Method Get -Uri $getAllChannelsUri -Headers $headers 
if($response -ne $null) 
{
  foreach($channelData in $response.value) 
    { 
        $channelVideoInfoUri= $baseURI + "/channels/$($channelData.id)/videos?`$top=100&`$skip=0&`$filter=published%20and%20(state%20eq%20%27completed%27%20or%20contentSource%20eq%20%27livestream%27)&`$expand=creator,events,channels&adminmode=true&`$orderby=metrics%2FtrendingScore%20desc&api-version=1.4-private"
        $channelVideoRes = Invoke-RestMethod -Method Get -Uri $channelVideoInfoUri -Headers $headers 
        foreach($channelVideo in $channelVideoRes.value) 
        { 
            $ChannelVideoAssociationInfo = [PSCustomObject] @{ 
                GroupID=$channelData.group.id 
                GroupName=$channelData.group.name
                ChannelID =$channelData.id 
                ChannelName=$channelData.name 
                VideoID=$channelVideo.id 
                VideoName=$channelVideo.name 
            } 
            $ChannelVideoInfoCollection += $ChannelVideoAssociationInfo 
        } 
}}  
$ChannelVideoInfoCollection | Export-Csv -Path $channelVideoReportPath -NoTypeInformation  

Script 2:

# Path to Token file    
$tokenInputFile="C:\temp\StreamReportGenerator\token.txt"      
$token = Get-Content -Path $tokenInputFile 
# To be replaced by Aad Tenant ID of your tenant
    $aadTenantID = "c008191f-7c3e-4728-a223-0cba39479b7b" 
    $tenantPatchUri = "https://api.microsoftstream.com/api/tenants/" +  $aadTenantID + "?api-version=1.4-private" 
    $headers = @{ 
        Authorization = "Bearer $token" 
    } 
    $body = "{}" 
    try { 
        $response = Invoke-RestMethod -Uri $tenantPatchUri -Method Patch -Body $body -Headers $headers -ContentType "application/json" 
  } 
    catch {
        #Stop execution if Unauthorized(401). 
        if ($_.Exception.Response.StatusCode.value__ -eq 401) { 
            Write-Host "========Enter new token and start the script again=======" 
        } 

          Write-Host "An error occurred: $($_.Exception.GetType().FullName) - $($_.Exception.Message)"

        exit 
    }
    Write-Host "Base URI: $($response.apiEndpoint)"

Passos para utilizar os scripts:

  1. Podemos utilizar o Script 1 para obter o mapeamento de canais e vídeo.
  2. Utilize a mesma forma de obter o token como no Relatório de Inventário e atualizar o $tokenInputFile
  3. Atualize o caminho channelVideoReport para onde pretende exportar o ficheiro csv do relatório de vídeo
  4. Temos de substituir $baseURI = "https://uswc-1.api.microsoftstream.com/api/" pelo BaseURI do seu inquilino. Para obter o URI Base, siga os passos: a. Script de Utilizador 2 e adicione o caminho para o ficheiro de token obtido no Passo 2 e atribua-o ao $tokenInputFile b. Substitua $aadTenantID = "c008191f-7c3e-4728-a223-0cba39479b7b" pelo ID de inquilino do seu inquilino c. Execute o script. d. Obtém o URI Base impresso na consola.
  5. Execute o Script 1 e o ChannelVideoReport é exportado para um determinado caminho
  6. Por predefinição, o script devolve os 100 principais canais e os 100 melhores vídeos nesses canais.

No site de destino, posso encontrar mais ficheiros do que os que foram migrados no relatório.

Devido a limitações no mecanismo de carregamento da migração, se ocorrerem erros "MJOBNOTCOMPLETED" ou "MJOBFATALERROR" no relatório, o número real de ficheiros migrados com êxito poderá exceder a contagem apresentada no relatório. A nova execução da migração é frequentemente eficaz na resolução destes problemas. Além disso, aguarde 15 minutos após a conclusão da migração antes de transferir os registos de migração e o relatório de resumo para evitar o erro MJOBNOTCOMPLETED no relatório.

Não consigo transferir os registos de migração da ferramenta.

Os registos de migração de qualquer contentor só estão disponíveis durante 3 meses após a migração desse contentor. Após três meses, os registos não estarão acessíveis.