Создание новых списков и библиотек документов

Встроенные командлеты PowerShell можно использовать совместно с SharePoint.NET API для оперативного создания списков и библиотек документов. Вот пример такого кода:

Function New-SPList()

(

Param(

[Parameter(

Position=0,

Mandatory=$true,

ValueFromPipeline=$true

)]

[Microsoft.SharePoint.SPWeb]$SPWeb,

[Parameter(

Position=l,

Wandatory=$true

)]

[string]$Title,

[Parameter(

Position=2,

Mandatory=$false

)]

[string]$Description = "",

[Parameter(

Position=3,

Mandatory=$false

)]

[string]$ListTemplateType = "DocumentLibrary"

)

$SPWeb.Lists.Add($Title, $Description, $ListTemplateType)

Вызвать эту функцию можно с помощью примерно такого кода:

Get-SPWeb " http://portal.companyABC.com/A-Project-Site " I New-SPList 4>-Title "Sample Doc. Lib" -Description "Пример Doc. Lib. Sample"

Get-SPWeb " http://portal.companyABC.com/A-Project-Site " | New-SPList 4>-Title "Sample Custom List"

Ч^-Description "Пример пользовательского списка" -ListTemplateType "GenericList"

Get-SPWeb " http://portal.companyABC.com/A-Project-Site " | New-SPList 'b-Title "Sample Calendar"

^-Description "Пример календаря" -ListTemplateType "Events"

В этом примере в сайте SharePoint (http: //portal.companyABC. com/A-Project-Site) создаются три списка. Функция New-SPList принимает три параметра: Title, Description и ListTemplateType. Необходимо указать уникальное в пределах сайта имя списка; для передачи нужного значения шаблона приходится просмотреть содержимое перечисления SPListTemplateType. Более подробную информацию можно получить по адресу

http://msdn.microsoft.com/en-us/library/microsoft.SharePoint. splisttemplatetype(office.14).aspx

Изменение свойств списка

Допустим, что владельцу сайта необходимо унифицировать параметры версий для всех списков и библиотек в ферме сайтов. В такой ситуации поможет сочетание PowerShell и API: нужно объединить имеющиеся командлеты Get-SPSite и Get-SPWeb с пользовательской функцией:

Function Set-SPList()

<

Param(

[Parameter(

Position=0,

Mandatory=$true,

ValueFromPipeline=$true

)]

[Microsoft.SharePoint.SPList]$SPList,

[Parameter(Mandatory=$false)]

[bool]$EnableVersioning = $null,

[Parameter(Mandatory=$false)]

[bool]$EnableMinorVersions = $null,

[Parameter(Mandatory=$false)]

[int]$MajorVersionLimit = -1,

[Parameter(Mandatory=$false)]

[int]$MajorWithMinorVersionsLimit = -1

)

if($SPList -ne $null) {

if($EnableVersioning -ne $null) (

$SPList.EnableVersioning = $EnableVersioning

)

if($MajorVersionLimit -gt -1) {

SSPList.MajorVersionLimit = $MajorVersionLimit) '

if($SPList.BaseType -eq "DocumentLibrary") (if($EnableMinorVersions -ne $null) {

SSPList.EnableMinorVersions = SEnableMinorVersions

if($MajorWithMinorVersionsLimit -gt -1) { $SPList.MajorWithMinorVersionsLimit = $MajoiWithMinorVersionsLimit

)

}

$SPList. Update ()

}

)

Если администратору требуется разрешить наличие пяти главных версий и всех второстепенных версий для каяадой из трех последних главных версий, то эту функцию нужно вызвать так:

Get-SPSite I Get-SPWeb -Limit All I ForEach-Object 4>{Get-SPList S_ I ForEach-Object

4MSet-SPList $_ -EnableMinorVersions $true -EnableVersioning $true ’Ъ-MajorVersionLimit 5 •fe-MajorWithMinorVersionsLimit 3})

Оперативное создание элементов списков

При создании сайтов, предназначенных для демонстрации и презентаций, может пригодиться функция PowerShell для создания элементов в списках. Ниже приведен пример такой функции. Она создает элемент в пользовательском списке и назначает ему только заголовок, но ее можно расширить так, чтобы создавать и более сложные элементы.

Function New-SPListItem()

{

Param(

[Parameter(

Position=0,

Mandatory=$true,

ValueFromPipeline=$true

)]

[Microsoft.SharePoint.SPList]$SPList,

[Parameter(

Position=l,

Mandatory=$true

)1

[string]STitle

)

[Microsoft.SharePoint.SPListltem] $listltem = SSPList. Items. Add ();

$listltem["Title"] = STitle Slistltem.Update()

»

Для вызова этой функции можно ввести такой код:

Get-SPWeb " http://portal.companyABC.com/A-Proiect-Site " I 4>Get-SPList -Title "The Team" I 4>New-SPListltem -Title "Иван Белов"

Get-SPWeb " http://portal.companyABC.com/A-Proiect-Site " |

4>Get-SPList -Title "The Team" |

4>New-SPListltem -Title "Анна Зеленская"

Get-SPWeb " http://portal.companyABC.com/A-Proiect-Site " I 4>Get-SPList -Title "The Team" |

4>New-SPListltem -Title "Зоя Серая"

Этот код создает три новых элемента (Иван Белов, Анна Зеленская и Зоя Серая) в списке "The Team", находящемся в сайте:

" http://portal.companyABC.com/A-Project-Site "