第 3 章 PowerShell スクリプトを利用した管理タスクの自動化
3.3 PowerShell によるリストアイテムの収集
66
67
1. Get-SPWebでContosoサイトのサブサイトオブジェクトを取得します。
取得したサブサイトオブジェクトはWebsコレクション プロパティを持つので、このプロパティがNULLでない場合は、さ らに、サブサイトを持つことがわかります。
サブサイトコレクションの各メンバを取得し、取得したサブサイトオブジェクトのListsコレクションの中から「月別売上報 告」リストのタイトルをもつリストを取得して、そのリストのItemsコレクションからアイテムのタイトルとファイル名を取得し ます。
PowerShell ISEを起動し、3.2で作成したスクリプトに従って、SharePointスナップインの読み込み処理を編集し、
その後、Get-SPWebコマンドレットからContosoサイトのサブサイトオブジェクトを取得します。
$snapInInfo = Get-PSSnapin | `
Where-Object{$_.Name –eq “Microsoft.SharePoint.PowerShell”}
if ($snapInInfo –eq $null) {
# SharePoint スナップインが追加されていないので追加する Add-PSSnapin Microsoft.SharePoint.PowerShell }
$rootweb = Get-SPWeb -Identity "http://sp2010/Sites/Contoso"
68
2. $rootwebのWebsプロパティを調べ、NULLでない場合はForEachステートメントでWebsコレクションのメンバを
取得します。
$webs = $rootweb.Webs if ($webs –ne $null) {
ForEach($web in $webs) {
# ここで、$websコレクションからメンバを取得する }
}
69
3. ForEachで取得したメンバはListsコレクションを持ちます。このリストコレクションに対し、Where-Objectコマンドレッ
トでTitleプロパティが「月別売上報告」のリストオブジェクトを取得します。この操作によって月別売上報告
DocumentLibraryオブジェクトが取得されます。このオブジェクトからSelect-ObjectコマンドレットでItemsプロパテ
ィを取得するとアップロードしたドキュメントオブジェクトのコレクションが取得されます。
ForEach($web in $webs) {
$web.Lists | Where-Object{$_.Title -eq "月別売上報告"} ` | Select-Object items # 月別売上報告リストのアイテムコレクションを取得 }
編集内容をC:¥Scripts¥GetListItem.ps1として保存し、F5キーを押して実行すると月別売上報告ドキュメントライ ブラリにアップされたドキュメントのアイテム一覧が取得されていることが確認できます。
70
4. 3の操作で取得したItemコレクションのメンバを取り出すと、アップロードした個々のドキュメントに関する情報を得る ことができます。
そこで、Select-Objectコマンドレットを使用して取得したItemsコレクション プロパティはパイプを使用して ForEach-Objectコマンドレットに渡します。
ForEach-Objectコマンドレットはパイプを通して渡されるコレクションのメンバを取得するコマンドレットです。
取得したオブジェクトはスクリプトブロック { } 内で、PowerShellの自動変数 $_ でアクセスすることができます。
ForEach-Objectコマンドレットで取得したオブジェクトのItemsプロパティに格納されたオブジェクトのTitleプロパティ
とFileプロパティを取り出すと、ライブラリにアップロードしたファイルに対応したタイトルとファイルを取得することができま す。
ForEach($web in $webs) {
$web.Lists | Where-Object{$_.Title -eq "月別売上報告"} | ` Select-Object items | ForEach-Object{$_.Items} | ` Select-Object Title,File | Format-Table -Auto }
71
5. Contosoサイトの営業サブサイトに用意した、月別売上報告ドキュメントライブラリからアップロードしたドキュメントの
タイトルとファイル名の一覧を取得するスクリプトは以下のようになります。
GetListItem.ps1
# SharePointスナップインが読み込まれているか調べる
$snapInInfo = Get-PSSnapin | `
Where-Object{$_.Name –eq "Microsoft.SharePoint.PowerShell"}
if ($snapInInfo –eq $null) {
# SharePoint スナップインが追加されていないので追加する Add-PSSnapin Microsoft.SharePoint.PowerShell }
$rootweb = Get-SPWeb -Identity "http://sp2010/Sites/Contoso"
$webs = $rootweb.Webs if ($webs –ne $null) {
ForEach($web in $webs) {
$web.Lists | Where-Object{$_.Title -eq "月別売上報告"} | ` Select-Object items | ForEach-Object{$_.Items} | ` Select-Object Title ,File | Format-Table -Auto }
}
72 実行結果
73