Exportar configurações de experiência do Microsoft OneDrive

Artigo
03/08/2023

A experiência do Microsoft OneDrive de um usuário armazena informações para ajudar o usuário a encontrar e navegar até o conteúdo de interesse para eles. A maioria dessas informações pode ser acessada por usuários finais usando os recursos correspondentes no produto listados na tabela a seguir:

Experiência	Dados armazenados	Acesso de Usuário
Itens compartilhados	Uma lista de documentos compartilhados com o usuário por outras pessoas. Ele também apresenta uma exibição dos documentos que o usuário compartilhou com outras pessoas, que é uma exibição das permissões que o usuário definiu nos itens em sua conta do OneDrive.	NA partir do OneDrive de um usuário, selecione Compartilhados.
Notificações por push para aplicativos móveis	Notificações por push para os aplicativos móveis OneDrive e SharePoint dos usuários, se configurados. Isso inclui atividades relevantes, como novos arquivos compartilhados com eles. Os administradores podem gerenciá-los na página Configurações do novo centro de administração do SharePoint.
Sites e conteúdos seguidos	Os usuários podem seguir sites, documentos ou pessoas. Os sites seguidos podem ser exibidos usando as experiências no produto.	Os sites seguidos podem ser exibidos e gerenciados na experiência do SharePoint Home. Essa experiência mostra sites recentes também. Na conta do OneDrive for Business de um usuário, é possível escolher o ícone de engrenagem Configurações, escolha Configurações do Site e, em seguida, Feed de atividades. No lado direito, eles podem clicar no tipo de conteúdo apropriado em estou seguindo.
News feed	Uma lista de atividades do usuário, incluindo conteúdo seguido, menções e alterações de perfil. Os usuários podem acessá-lo usando experiências no produto.	Na conta do OneDrive de um usuário, é possível escolher o ícone de engrenagem Configurações, escolha Configurações do Site e, em seguida, Feed de atividades. As configurações de news feed podem ser gerenciadas como parte da experiência do perfil de usuário, que foi descrita anteriormente.
Solicitações de acesso	Uma lista de acesso solicitado ao conteúdo.	Na conta do OneDrive de um usuário, é possível escolher o ícone de engrenagem Configurações, escolha Configurações do Site e, em seguida, Solicitações de Acesso e Convites

Um administrador pode exportar essas listas usando comandos PnP PowerShell e CSOM (Modelo de Objeto Client-Side) do SharePoint neste artigo. Todos os assemblies CSOM necessários estão incluídos no módulo Do Microsoft PowerShellOnline do SharePointPnPPowerShellOnline.

Este é um script de exemplo e pode ser adaptado para atender às necessidades da sua organização. Por exemplo, um administrador pode extrair as informações usando user1@contoso.com o procedimento a seguir.

Atribua a você mesmo permissões de administrador para acessar a conta do OneDrive do usuário. Isso pode ser feito no Centro de administração do Microsoft 365.
Instale os módulos necessários do Microsoft PowerShell:

Install-Module SharePointPnPPowerShellOnline

Install-Module CredentialManager
Execute o script ExportODBLists do PowerShell abaixo (ou uma versão personalizada do script):

$ODBSite = "https://contoso-my.sharepoint.com/personal/user1_contoso_com"

ExportODBLists.ps1 -siteUrl $ODBSite

O script exportará dados armazenados para os recursos descritos na tabela anterior para vários arquivos CSV. O administrador pode revisar ou redigir antes de fornecê-los ao usuário final.

O script cria os seguintes arquivos CSV (se as listas correspondentes forem encontradas). O nome do arquivo CSV corresponde ao título da lista.

Arquivo	Descrição
(Referência, <id>).csv, em que <a ID> é uma sequência de letras e números	Lista de itens compartilhados com o usuário
Como compartilhar Links.csv	Lista de links de compartilhamento gerados pelo usuário
userActivityFeedHiddenListF4387007-BE61-432F-8BDB-85E6B9679E4B.csv	Lista de atividades relevantes
notificationSubscriptionHiddenList6D1E55DA-2564-4A22-A5F9-6C4FCAFF53DE.csv	Lista de notificações enviadas a aplicativos móveis e IDs de aplicativo desses dispositivos
Social.csv	Lista de conteúdo seguido
MicroFeed.csv	Lista de itens de News feed
Acessar Requests.csv	Lista de solicitações de acesso
SharePointHomeCacheList.csv	Dados armazenados em cache do usuário navegando até o SharePoint Home. Isso é atualizado sempre que o usuário navega até o SharePoint Home.

Script ExportODBLists

Copie o conteúdo abaixo e cole-os em um arquivo de texto. Salve o arquivo como ExportODBLists.ps1. O script pode exportar todos os campos das listas de destino usando o exportAllFields parâmetro. O script pode ser modificado para exportar todas as listas e para manipular outros sites também.

Observação

Se você vir um erro sobre um assembly não ser carregado, verifique novamente o caminho para a versão mais recente do Módulo powershell do SharePointPnPPowerShellOnline, conforme definido nos parâmetros Add-Type Path. O caminho pode ser diferente no computador ou você pode estar usando uma versão diferente do módulo (a versão do módulo faz parte do caminho).

#ExportODBLists
#Exports OneDrive experience settings, stored in several SharePoint lists

param([string]$siteUrl, [bool]$exportAllFields=$false, [bool]$useStoredCreds=$true, [string]$exportFolder)
Add-Type -Path "C:\Program Files\WindowsPowerShell\Modules\SharePointPnPPowerShellOnline\2.26.1805.0\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\WindowsPowerShell\Modules\SharePointPnPPowerShellOnline\2.26.1805.0\Microsoft.SharePoint.Client.Runtime.dll"

if (!$siteUrl)
{
    Write-Host "Please specify a OneDrive site using -siteUrl."
    return
}

if ($useStoredCreds)
{
    Write-Host "Retrieving stored Windows credentials for $siteUrl."
    $cred = Get-StoredCredential -Target $siteUrl
    if (!$cred)
    {
        Write-Host "Didn't find stored credential for $siteUrl. Please provide credentials to connect."
        $cred = Get-Credential
    }
}
else
{
   $cred = Get-Credential
}

$credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($cred.UserName,$cred.Password)
$webURL = $siteUrl
$ctx = New-Object Microsoft.SharePoint.Client.ClientContext($webURL)
$ctx.Credentials = $credentials

#root folders of lists to export
$SWMRoot = "Reference " #starts with this string
$notificationsRoot = "notificationSubscriptionHiddenList6D1E55DA25644A22"
$activityFeedRoot = "userActivityFeedHiddenListF4387007BE61432F8BDB85E6"
$accessRequestsRoot = "Access Requests"
$microfeedRoot = "PublishedFeed"
$SPHomeCacheRoot = "SharePointHomeCacheList"
$sharingLinksRoot = "Sharing Links"
$socialRoot = "Social"

#list fields to eexport
$SWMFields = @("ID","Created","Modified","Title","RemoteItemPath","OwnerDisplayName","OwnerSipAddress","RemoteItemFileSystemObjectType",
                "RemoteItemCreatorDisplayName","RemoteItemCreatorSipAddress","RemoteItemCreatedDateTime",
                "RemoteItemModifierDisplayName","RemoteItemModifierSipAddress","RemoteItemModifiedDateTime",
                "SWMSharedByDisplayName","SWMSharedBySipAddress","SWMSharedByDateTime",
                "RemoteItemLastAccessedDateTime","RemoteItemServerRedirectedUrl","RemoteItemServerRedirectedEmbedUrl")
$accessRequestsFields = @("ID","Created","Modified","Title","RequestId","RequestedObjectTitle","RequestedObjectUrl","PermissionType","PermissionLevelRequested","RequestDate",
                            "RequestedByDisplayName","RequestedBy","ReqByUser",
                            "RequestedForDisplayName","RequestedFor","ReqForUser",
                            "ApprovedBy","AcceptedBy","Status","Expires","WelcomeEmailSubject","WelcomeEmailBody","ExtendedWelcomeEmailBody","Conversation")
$microfeedFields = @("ID","Created","Modified","Title","MicroBlogType","PostAuthor","RootPostOwnerID","RootPostUniqueID","ReplyCoungett","Order","ContentData")
$notificationsFields = @("ID","Created","Modified","Title","SubscriptionId","PoolName","SecondaryPoolName","AppType","NotificationHandle",
                            "SecondsToExpiry","DestinationType","SubmissionDateTime","ExpirationDateTime","Locale","DeviceId","HostName","NotificationCounter",
                            "SingleSignOutKey","NotificationScenarios","ComplianceAssetId","AppAuthor","AppEditor")
$SPHomeCacheFields = @("ID","Created","Modified","Author","Editor","Title","Value")
$sharingLinksFields = @("ID","Created","Modified","Title","SharingDocId","ComplianceAssetId","CurrentLink","AvailableLinks")
$socialFields = @("ID","Created","Modified","Author","Editor","Title","Url","Hidden","HasFeed","SocialProperties")
$activityFeedFields = @("ID","Created","Modified","Title","ActivityId","ItemId","PushNotificationsSent","EmailNotificationSent","IsActorActivity","IsRead","Order",
                        "ItemChildCount","FolderChildCount","ActivityEventType","ActivityEvent")


#get lists in the web
try{
    $lists = $ctx.web.Lists
    $ctx.load($lists)
    $ctx.executeQuery()
}
catch{
    write-host "$($_.Exception.Message)" -foregroundcolor red
}


#identify the lists to export
$listsToExport = @()
foreach($list in $lists)
{
    $ctx.load($list)
    $ctx.load($list.RootFolder)
    $ctx.executeQuery()
    $listTitle = [string]$list.Title
    $listRoot = $list.RootFolder.Name

    Write-host ("Processing List: " + $list.Title + " with " + $list.ItemCount + " items").ToUpper() -ForegroundColor Yellow
    Write-host (">> List Root Folder: " + $listRoot) -ForegroundColor Yellow

    if ($listRoot.StartsWith($SWMRoot,"CurrentCultureIgnoreCase") -and $list.ItemCount -ge 1)
    {
        Write-Host ">> Found: Shared With Me List" -ForegroundColor Green
        $listDetails = @{listType = "Shared With Me List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $SWMFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $notificationsRoot)
    {
        Write-Host ">> Found: Notifications List" -ForegroundColor Green
        $listDetails = @{listType = "Notifications List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $notificationsFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $activityFeedRoot)
    {
        Write-Host ">> Found: User Activity Feed List" -ForegroundColor Green
        $listDetails = @{listType = "User Activity Feed List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $activityFeedFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $accessRequestsRoot)
    {
        Write-Host ">> Found: Access Requests List" -ForegroundColor Green
        $listDetails = @{listType = "Access Requests List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $accessRequestsFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $microfeedRoot)
    {
        Write-Host ">> Found: MicroFeed List" -ForegroundColor Green
        $listDetails = @{listType = "Microfeed List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $microfeedFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $SPHomeCacheRoot)
    {
        Write-Host ">> Found: SharePoint Home Cache List" -ForegroundColor Green
        $listDetails = @{listType = "SharePoint Home Cache List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $SPHomeCacheFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $sharingLinksRoot)
    {
        Write-Host ">> Found: Sharing Links List" -ForegroundColor Green
        $listDetails = @{listType = "Sharing Links List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $sharingLinksFields}
        $listsToExport += $listDetails
    }
    elseif ($listRoot -eq $socialRoot)
    {
        Write-Host ">> Found: Social List" -ForegroundColor Green
        $listDetails = @{listType = "Social List"; listTitle = $listTitle; listRoot = $listRoot; listFields = $socialFields}
        $listsToExport += $listDetails
    }

}

#export list function
function exportList
{
    Param ([string] $listTitle, [string[]]$listFields, [string]$exportFile)

    Write-Host ("Exporting List: " + $listTitle).ToUpper() -ForegroundColor Green
    Write-Host (">> File location: $exportFile") -ForegroundColor Green

    #Get the list items
    $list = $lists.GetByTitle($listTitle)
    $listItems = $list.GetItems([Microsoft.SharePoint.Client.CamlQuery]::CreateAllItemsQuery())
    $fieldColl = $list.Fields
    $ctx.load($listItems)
    $ctx.load($fieldColl)
    $ctx.executeQuery()

    if ($listFields) #if you're passing a specific set of fields, in a specific order, process those
    {
         #Array to Hold List Items
         $listItemCollection = @()
         #Fetch each list item value to export to excel
         foreach($item in $listItems)
         {
            $exportItem = New-Object PSObject

            Foreach ($field in $listFields)
            {
                    if($NULL -ne $item[$field])
                    {
                        #Expand the value of Person or Lookup fields
                        $fieldType = $item[$field].GetType().name
                        if (($fieldType -eq "FieldLookupValue") -or ($fieldType -eq "FieldUserValue"))
                        {
                            $fieldValue = $item[$field].LookupValue
                        }
                        elseif ($fieldType -eq "FieldUrlValue")
                        {
                            $fieldValue = $item[$field].Url
                        }
                        else
                        {
                            $fieldValue = $item[$field]
                        }
                    }
                    $exportItem | Add-Member -MemberType NoteProperty -name $field -value $fieldValue
            }
            #Add the object with above properties to the Array
            $listItemCollection += $exportItem
         }
        #Export the result Array to CSV file
        $listItemCollection | Export-CSV $exportFile -NoTypeInformation
    }
    else #export all fields for the list
    {
         #Array to Hold List Items
         $listItemCollection = @()
         #Fetch each list item value to export to excel
         foreach($item in $listItems)
         {
            $exportItem = New-Object PSObject
            Foreach($field in $fieldColl)
            {
                    if($NULL -ne $item[$field.InternalName])
                    {
                        #Expand the value of Person or Lookup fields
                        $fieldType = $item[$field.InternalName].GetType().name
                        if (($fieldType -eq "FieldLookupValue") -or ($fieldType -eq "FieldUserValue"))
                        {
                            $fieldValue = $item[$field.InternalName].LookupValue
                        }
                        elseif ($fieldType -eq "FieldUrlValue")
                        {
                            $fieldValue = $item[$field].Url
                        }
                        else
                        {
                            $fieldValue = $item[$field.InternalName]
                        }
                    }
                    $exportItem | Add-Member -MemberType NoteProperty -name $field.InternalName -value $fieldValue
            }
            #Add the object with above properties to the Array
            $listItemCollection += $exportItem
         }
        #Export the result Array to CSV file
        $listItemCollection | Export-CSV $exportFile -NoTypeInformation
    }

}

#export the lists
foreach ($list in $listsToExport)
{
     #if we have a valid folder for export, use it, otherwise export to the current directory
     if ($exportFolder -and (Test-Path $exportFolder -PathType Container))
     {
         $filepath = Join-Path -Path $exportFolder -ChildPath ($list["listTitle"] + ".csv")
     }
     else
     {
         $filepath = ($list["listTitle"] + ".csv")
     }

     #export the lists
     if ($exportAllFields)
     {
         exportList -listTitle $list["listTitle"] -exportFile $filepath
     }
     else
     {
         exportList -listTitle $list["listTitle"] -listFields $list["listFields"] -exportFile $filepath
     }
}

Exportar configurações de experiência do Microsoft OneDrive

Script ExportODBLists

Recursos adicionais