SharePoint 2010 - Error "This item cannot be updated because it is locked as read-only"的解决方案

最近遇到一个问题，在SharePoint2010中无法edit, unlock或者declare一个file，在修改时候会显示下面错误"This item cannot be updated because it is locked as read-only".

并且无法使用PowerShell unlock file，在执行Undocheckout命令时会弹出下面error:

Exception calling "ReleaseLock" with "1" argument(s): "The operation on file "file location" cannot be completed because the specified lock arguments are not valid."

对于这种问题可以通过下面的script解决：（需要替换对应文件的URL并运行）

$recordFields =

  "_vti_ItemHoldRecordStatus",

  "_vti_ItemDeclaredRecord"

 

$recordProperties =

  "ecm_RecordRestrictions",

  "ecm_ItemLockHolders",

  "ecm_ItemDeleteBlockHolders"

 

$fileUrl = "http://siteURL/siteCollection/libraryName/folder/subFolder/fileName.pdf"

 

$sharePointAssembly = [System.Reflection.Assembly]::Load("Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c")

 

Add-Type -TypeDefinition @"

using Microsoft.SharePoint;

 

public class EventsDisabler : SPEventReceiverBase

{

  public EventsDisabler() {}

  

  public bool EventsDisabled

  {

    get { return !EventFiringEnabled; }

    set { EventFiringEnabled = !value; }

  }

}

"@ -ReferencedAssemblies $sharePointAssembly

 

Write-Host "Getting site collection at $fileUrl..."

[Microsoft.SharePoint.SPSite]$site = New-Object Microsoft.SharePoint.SPSite($fileUrl)

if ($site -eq $null) { exit }

$siteUrl = $site.Url

Write-Host "Found site collection $siteUrl"

Write-Host ""

 

Write-Host "Getting web at $fileUrl..."

[Microsoft.SharePoint.SPWeb]$web = $site.OpenWeb()

if ($web -eq $null) { exit }

$webTitle = $web.Title

Write-Host "Found web $webTitle"

Write-Host ""

 

Write-Host "Verifying current user is System Account"

$web.CurrentUser.ID

$site.SystemAccount.ID

if ($web.CurrentUser.ID -ne $site.SystemAccount.ID)

{

  Write-Error "Please run this script as System Account" -Category PermissionDenied

  #exit

}

Write-Host ""

 

Write-Host "Getting list at $fileUrl..."

Write-Host $fileUrl

[Microsoft.SharePoint.SPList]$list = $web.GetList($fileUrl)

if ($list -eq $null) { exit }

$listTitle = $list.Title

Write-Host "Found list $listTitle"

Write-Host ""

 

Write-Host "Getting list item at $fileUrl..."

[Microsoft.SharePoint.SPListItem]$listItem = $web.GetListItem($fileUrl)

if ($listItem -eq $null) { exit }

$listItemName = $listItem.Name

Write-Host "Found list item $listItemName"

Write-Host ""

 

$eventsDisabler = New-Object EventsDisabler

$eventsOriginallyDisabled = $eventsDisabler.EventsDisabled

if ($eventsOriginallyDisabled -eq $false)

{

  Write-Host "Disabling events"

  $eventsDisabler.EventsDisabled = $true

  Write-Host ""

}

 

$didWork = $false

$itemNeedsUpdate = $false

 

#Discard any check-out

if ($listItem.File -ne $null -and $listItem.File.CheckOutType -ne [Microsoft.SharePoint.SPFile+SPCheckOutType]::None)

{

  Write-Host "Undoing check-out"

  $listItem.File.UndoCheckOut()

  $didWork = $true

}

else

{

  Write-Host "No file or file is not checked out"

  Write-Host ""

}

 

#Iterate the Record fields and set all values to null

foreach($recordField in $recordFields)

{

  if ($listItem.Fields.ContainsField($recordField) -eq $true -and $listItem[$recordField] -ne $null)

  {

    $recordFieldValue = $listItem[$recordField]

    Write-Host "$recordField = $recordFieldValue"

    Write-Host "Setting $recordField to null"

    $listItem[$recordField] = $null

    $didWork = $true

    $itemNeedsUpdate = $true

  }

}

 

#Iterate the Record properties and remove any that exist

foreach($recordProperty in $recordProperties)

{

  if ($listItem.Properties.ContainsKey($recordProperty) -eq $true)

  {

    $recordPropertyValue = $listItem.Properties[$recordProperty]

    Write-Host "$recordProperty = $recordPropertyValue"

    Write-Host "Removing property $recordProperty"

    $listItem.Properties.Remove($recordProperty)

    $didWork = $true

    $itemNeedsUpdate = $true

  }

}

 

#Remove the icon Record lock overlay

if ($listItem.IconOverlay -eq "lockoverlay.png")

{

  Write-Host "Removing the icon Record lock overlay"

  $listItem.IconOverlay = $null

  $didWork = $true

  $itemNeedsUpdate = $true

}

 

if ($didWork -ne $true)

{

  Write-Host "No changes were made"

}

Write-Host ""

 

#Update the item

if ($itemNeedsUpdate -eq $true)

{ 

  Write-Host "Updating item"

  $listItem.SystemUpdate()

  

  Write-Host ""

}

 

if ($eventsOriginallyDisabled -ne $true)

{

  Write-Host "Enabling events"

  $eventsDisabler.EventsDisabled = $false

  Write-Host ""

}

 

$web.Dispose()

$site.Dispose()

 

执行完成后，文件可以正常编辑修改， 问题解决。

此script只适用于在SharePoint2010运行，如果需要在其他版本，需要更新$SharePointAssembly行。

 

记录一下方便之后使用， 感谢阅读。