SharePoint自动化系列——Add/Remove “Hold” from items

转载请注明出自天外归云的博客园:http://www.cnblogs.com/LanTianYou/

问题1:

1.如果SharePoint item被添加了hold,通过UI界面来对SharePoint items解锁是比较折腾的。

2.而且这其中存在一个问题,我们可以看作是已知问题——对于文件的解锁,是可以通过UI界面完成的;而对于list中的items,我们通过UI界面是无法完成解锁的,因为当你在item中上传附件并对其添加hold后,你是无法通过item的Property->Advanced再进入Compliance details中的,所以无法完成对item附件的解锁。

而对于以上的两个问题——解锁过程的繁琐和无法解锁,我们可以通过一个脚本来解决:

Add-PSSnapin Microsoft.SharePoint.PowerShell
function RemoveHolds($siteURL,$listTitle)
{
    $site = Get-SPSite $siteURL
    $web = $site.RootWeb
    $list = $web.Lists[$listTitle]
    $items = $list.Items
    $holds = $web.Lists["Holds"].Items
    $holdsCount = $holds.Count
    Write-Host "Holds in this site:" -ForegroundColor DarkCyan
    for($i=0;$i -lt $holdsCount;$i++)
    {
        $tip = "["+$i+"] "+$holds[$i].title
        Write-Host $tip -ForegroundColor DarkYellow
    }
    $choose = Read-Host "Choose the hold you wanna remove from items"
    $itemHold = $web.Lists["Holds"].items[[int]$choose]
    [Microsoft.Office.RecordsManagement.Holds.Hold]::RemoveHold($items,$itemHold,"Hold removed from all the items")
    $web.Dispose()
    $site.Dispose()
}
$siteURL = "http://exhv-3073/sites/1116site1"
$listTitle = "1116docLib"
RemoveHolds $siteURL $listTitle

直接在PowerShell或者PowerShell ise中运行这段脚本:

SharePoint自动化系列——Add/Remove “Hold” from items

如上所示,在输入siteURL和listTitle后运行程序,选择相应的hold,就可以对list中的items进行解锁了。解锁后的items就可以正常进行编辑或删除了。

问题2:

1.为items添加hold和remove hold from items一样麻烦;

2.无法批量地为items添加hold。

同样用一个脚本解决,只需要将上段代码中稍作修改即可:

Add-PSSnapin Microsoft.SharePoint.PowerShell
function AddHolds($siteURL,$listTitle)
{
    $site = Get-SPSite $siteURL
    $web = $site.RootWeb
    $list = $web.Lists[$listTitle]
    $items = $list.Items
    $holds = $web.Lists["Holds"].Items
    $holdsCount = $holds.Count
    Write-Host "Holds in this site:" -ForegroundColor DarkCyan
    for($i=0;$i -lt $holdsCount;$i++)
    {
        $tip = "["+$i+"] "+$holds[$i].title
        Write-Host $tip -ForegroundColor DarkYellow
    }
    $choose = Read-Host "Choose the hold you wanna add to items"
    $itemHold = $web.Lists["Holds"].items[[int]$choose]
    [Microsoft.Office.RecordsManagement.Holds.Hold]::SetHold($items,$itemHold,"Hold added")
    $web.Dispose()
    $site.Dispose()
}
$siteURL = "http://exhv-3073/sites/1116site1"
$listTitle = "1118docLib"
AddHolds $siteURL $listTitle

直接在PowerShell或者PowerShell ise中运行这段脚本:

SharePoint自动化系列——Add/Remove “Hold” from items

另,一键执行所有和Hold processing and reporting的jobs:

#Run the 'Hold processing and reporting'timer jobs.
$jobs = Get-SPTimerJob|where{$_.name -like '*hold*'}
foreach($job in $jobs)
{
    Start-SPTimerJob $job
}

或:

Get-SPTimerJob|where{$_.name -like '*Hold*'}|Start-SPTimerJob

参考文献:

How to add to a hold using Powershell and Programmatically in SharePoint 2010

How to remove from a hold using PowerShell and programmatically in SharePoint 2010

上一篇:关闭vue.js代码规范Eslint,脚手架新版以及旧版,简单方式


下一篇:自动调整速率的Actor设计模式