Скрипт который позволяет выкачать все вложения и разложить и по соответствующим папкам.

   

Результат:

Скрипт пробегается по всем записям начиная с меньшего ID. Мне так и не удалось ‘скормить’ caml-запрос команде Get-PnPListItem, хотя параметр -Query у этой команды раньше там был.

Поэтому добавил маленький блок-настройку на 38-ой строке, где можно добавить своё условие. К примеру: вам нужно выгрузить не все вложения, а только для записей из Москвы или регионов. Тогда можно заменить условие ниже:

$condition = $true

на например что-то такое:

$condition = ($listItem.City -eq «Moscow») -or ($listItem.City -eq «Moscow Region»)

# или к примеру чтобы выгрузить аттачменты только начиная с какого-то элемента/времени:
$condition = ($listItem.ID -gt 7000)

ну и так далее.

Скрипт поддерживает threshold > 5000 и также работает с большими списками.

Код:

$url="https://portal.sharepoint.com/sites/web/"

# здесь может быть diplay name или guid 
$listName="Listname"  

# кроме системных полей
$includeHiddenField = $False
$includeReadonlyField = $False

# по умолчанию 'C:\Users\Administrator'
$saveDir = (Resolve-path ".\")  

 
function ExportList  
{  

    # все поля кроме системных (возможно какое-то из полей будет удобно использовать в кач-ве названия папки)
    $listFields = Get-PnPField -List $listName |? { $_.Hidden -eq $includeHiddenField -AND $_.ReadOnlyField -eq $includeReadonlyField} | Select -ExpandProperty internalname

    $count = 0
    try  
    {  
        md .\$listName -Force
        md ".\$($listName)\Attachments" -Force

        
        $listItems=(Get-PnPListItem -List $listName -Fields $listFields -PageSize 1000).FieldValues
        
        foreach($listItem in $listItems)  
        {   
            $count = $count+1
            Write-Progress -Activity "Exporting" -Status "$($count/$listItems.Count*100)% Complete:" -PercentComplete $($count/$listItems.Count*100)

            $listItem.GetEnumerator() | Where-Object { $_.Key -in $listFields }| ForEach-Object{ 
                    
                    if($_.Key -eq "Attachments" -And $_.Value -eq "TRUE"){
                        
                        $condition = $true
                        #$condition = ($listItem.City -eq "Moscow") -or ($listItem.City -eq "Moscow Region")
                        #$condition = ($listItem.ID -gt 7000)
                        

                        if ( $condition )
                        {
                            Write-Output "Downloading file.."

                            # папка в данном примере содержит ID и Title 
                            $path = "$($listItem.ID)" + " - " + "$($listItem["Title"])"

                            # на практике записи SharePoint содержат спецсимволы или пробелы в конце, которые не позволят создать папку
                            # частично можно обойти так:
                            $path = $path -replace "[$([RegEx]::Escape([string][IO.Path]::GetInvalidFileNameChars()))]+"," "
                            $path = $path.Trim()
                            Write-Host $path

                        
                            md ".\$($listName)\Attachments\$($path)" -Force
                        
                            $item = Get-PnPListItem -List $listName -Id $($listItem.ID)
                        
                            $attachments = ForEach-Object{Get-PnPProperty -ClientObject $item -Property "AttachmentFiles"}
                            
                            $attachments | ForEach-Object {
                            
                                Get-PnPFile -Url $_.ServerRelativeUrl -FileName $_.FileName -Path ".\$($listName)\Attachments\$($path)"  -AsFile -Force
                            
                            } 
                        }
                    }
                }
                 
            Write-Host $count
        }  
  
     }  
     catch [Exception]  
     {  
        $ErrorMessage = $_.Exception.Message         
        Write-Host "Error: $ErrorMessage" -ForegroundColor Red          
     }  
}  
 

Connect-PnPOnline -Url $Url -UseWebLogin
 
ExportList  
 
Disconnect-PnPOnline

Реклама

Восстановление случайно удалённой сайт-коллекции.

Одна из документированных, но малоизвестных фозможностей SharePoint — восстановление случайно удалённой сайт-коллекции.

Если с сайтами-вебами всё относительно понятно и у нас есть два «форпоста» в виде корзины сайт-коллекции (http://server/_layouts/15/AdminRecycleBin.aspx?View=2 ),

и корзины Central Administration, то в случае удаления корневой коллекции которая их все и содержит — в корзине CA не будет ничего. А удаляется она так же просто, и из веб-интерфейса вообще никак не восстанавливается 🙂

Теоретически создателям было бы неплохо добавить какую-нибудь ‘проверку-защиту от дурака’, как например сделано на GitHub-е:

Но скорее всего её уже не впихнуть в существующую архитектуру да и вообще — это не наши методы 🙂

Как обычно — сначала создав нам проблему, SharePoint потом предлагает её решение: удалённая сайт-коллекция остаётся сидеть в объекте доступном по Get-SPDeletedSite:

Зная его SiteId, можно восстановить коллекцию сайтов обратно через Restore-SPDeletedSite:

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue
Get-SPDeletedSite
Restore-SPDeletedSite -Identity 8be8d8d4-a8c5-4eda-91cd-0c27b79a050d

p.s.: И да — при желании SharePoint спешит на помощь к особо упорным желающим убить ферму, и предоставляет коммандлет Remove-SPSite, который «cannot be undone» уже и в Powershell 🙂

 

 

 

 

Интеграция Powershell + SharePoint

iLoveSharepoint Power Webpart для Sharepoint 2010 позволяет вставлять скрипты на Powershell прямо в страницы портала.

Так как за powershell-ом лежит практически весь .NET(и не только), то это позволяет создавать интересные решения, без открытия студии и развёртывания wsp.

Для иллюстрации создадим какую-нибудь функцию на Powershell, к примеру будем приветствовать юзера в зависимости от времени суток. Имя текущего пользователя выведем в дружественном формате.

# подключим SharePoint безопасным образом
$sharePointSnapin = Get-PSSnapin | Where-Object { $_.Name -eq  "Microsoft.SharePoint.PowerShell"}
if($sharePointSnapin -eq $null)
{
    Add-PSSnapin Microsoft.SharePoint.PowerShell    
}


# поздороваемся с пользователем, в зависимости от времени суток
Function GetGreeting()
{
    # текущее время
    $actualtime = (Get-Date).TimeOfDay;

    # выберем интервал
    $evening = New-TimeSpan -Hours 17 -Minutes 30 -Seconds 0
    $morning = New-TimeSpan -Hours 8 -Minutes 0 -Seconds 0
    $dinner = New-TimeSpan -Hours 11 -Minutes 0 -Seconds 0
    $night = New-TimeSpan -Hours 22 -Minutes 0 -Seconds 0
    
    if ($actualtime -ge $morning -and $actualtime -le $dinner)
    {
        return "Доброе утро";
    }
    if ($actualtime -ge $dinner -and $actualtime -le $evening)
    {
        return "Добрый день";
    }
    if ($actualtime -ge $evening -and $actualtime -le  $night)
    {
        return "Добрый вечер";
    }
    if ($actualtime -ge  $night -or $actualtime -le  $morning)
    {   
	    # дикий случай, но допустим
        return "Доброй ночи :)";
    }
}


# для получения Display Name можно каждый раз делать запрос к домен-контроллеру, 
# но так как формат имени в домене имеет стандартный вид "Домен\Имя.Фамилия",
# то выведем friendly-имя прямо тут же в вебчасти
Function GetDisplayName($name)
{
    if($name -match "\\")
    {
        $name = $name.remove(0, $name.LastIndexOf('\')+1);
    }
    if($name -match ".")
    {
        $name = $name.replace("."," ");
    }
           
    return $name
}

# соберём всё вместе
$hello = (GetGreeting)+ ", " + (GetDisplayName -name ([Environment]::UserName))


# вывод html
function Render($writer)
{
    $writer.Write("<h1>$hello</h1>")
}

Результат работы такого кода:

Таким образом мы получаем динамическое поведение в Sharepoint, но без создания «полновесного» решения с кодом