SharePoint 2010: Comment Copier une Liste en Utilisant un Script PowerShell (fr-FR)
Note : Cet article est une traduction.
Introduction
Utilisez ce script (fonction) PowerShell pour copier une liste (ou une bibliothèque de documents) et tous ses éléments dans une nouvelle liste du même site ou d'un site différent. Vous pouvez seulement copier des listes et des bibliothèques de documents entre des sites de la même collection de sites.
Le script fonctionne en sauvegardant la liste en tant que template de liste, en incluant le contenu. Il crée ensuite une nouvelle liste, en se basant sur le template et dans le site de destination, en utilisant le nom de la liste de destination (si passé en paramètre, sinon le nom de la liste source est utilisé).
Le code PowerShell de base
En utilisant PowerShell, sauvegardez la liste en tant que template de liste, en incluant le contenu,créez ensuite une nouvelle liste, en se basant sur le template et dans le site de destination. Dans l'exemple suivant, la liste "Health Foods" est copiée depuis le site "Marketing" vers le site "Promotions" de la collection de sites "GoodFoods".
#Get the source and destination sites (SPWeb objects)
$site = New-Object Microsoft.SharePoint.SPSite("http://goodfoods/marketing")
$web = $site.OpenWeb()
$destinationSite = New-Object Microsoft.SharePoint.SPSite("http://goodfoods/promotions");
$destinationWeb = $destinationSite.OpenWeb()
#Define the source and destination list names
$SourceListName = "Health Foods";
$DestinationListName = "Health Foods";
#Connect to the source list
$sourceList = $web.Lists[$SourceListName];
#Create a unique name to use when saving the list as a template.
$id = [Guid]::NewGuid()
$templateName = [String]::Format("{0}-{1}",$sourceList.Title,$id.ToString());
$templateFileName = $templateName;
#Save the list as a list template. The forth parameter of the SaveAsTemplate method takes a boolean value indicating whether to save list data with the list.
$sourceList.SaveAsTemplate($templateFileName, $templateName, $sourceList.Description, $true)
#Get the list template that was just saved
$listTemplate = $site.GetCustomListTemplates($web)[$templateName]
#Create a new list at the destination web using the list template created from the source list
$destinationWeb.Lists.Add($destinationListName, $sourceList.Description, $listTemplate);
$destinationWeb.Update()
#Clean Up
#Delete the list the list template for, the List Template Fallery
$listTemplates = $site.RootWeb.Lists["List Template Gallery"]
$lt = $listTemplates.Items | ?{$_.Title -eq $templateName}
if($lt -ne $null){$lt.Delete();}
#Dispose of the SPWeb and SPSite objects
$web.Dispose();
$site.Dispose();
$destinationWeb.Dispose();
$destinationSite.Dispose();
Utiliser PowerShell comme fonction réutilisable
Le code PowerShell écrit en tant que fonction paramétrée peut être réutilisé. Il crée une nouvelle liste, basée sur le template, dans le site de destination, en utilisant le nom de la liste de destination (si passé en paramètre, sinon le nom de la liste source est utilisé).
function Copy-SPList{
################################################################
#.Synopsis
# Copies a list or document library from one web in a site collection to another web in the same site collection
#.DESCRIPTION
# Use this function to copy a list or document library and all of its items to a new list in the same web or a different web. You can only copy list and document libraries between webs in same site collection.
#.Parameter SourceWebUrl
# The full url to the web that hosts the list that will be copied
#.Parameter SourceListName
# The list title of the list that will be copied
#.Parameter DestinationWebUrl
# The full url to the web where the list will be copied to
#.Parameter DestinationListName
# The name given to the list created at the destination web. If this is omitted, the source list name will be used.
#.EXAMPLE
# Copy-SPList -SourceWebUrl http://corporate -SourceListName "SecretDocuments" -DestinationWebUrl http://corporate/moresecureweb
# Copy the SecretDocuments document library from the http://corporate web to the http://corporate/moresecure web, keeping the same list name.
#.EXAMPLE
# Copy-SPList -SourceWebUrl http://corporate -SourceListName "SecretDocuments" -DestinationWebUrl http://corporate/lesssecureweb -DestinationListName "NotSoSecretDocuments"
# Copy the SecretDocuments document library from the http://corporate web to the http://corporate/lesssecure web, changing the name of the list to "NotSoSecretDocuments".
#.EXAMPLE
# Copy-SPList -SourceWebUrl http://corporate -SourceListName "SecretDocuments" -DestinationWebUrl http://corporate -DestinationListName "ACopyOfTheSecretDocuments"
# Create a copy the SecretDocuments document library in the same web, http://corporate, with the new name "ACopyOfTheSecretDocuments".
################################################################
[CmdletBinding()]
Param(
[parameter(Mandatory=$true)][string]$SourceWebUrl,
[parameter(Mandatory=$true)][string]$SourceListName,
[parameter(Mandatory=$true)][string]$DestinationWebUrl,
[parameter(Mandatory=$false)][string]$DestinationListName
)
$numberOfActions = 6;
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (1/$numberOfActions *100) -Status "Connecting to the sourcen web, $SourceWebUrl.";
$site = New-Object Microsoft.SharePoint.SPSite($SourceWebUrl)
$web = $site.OpenWeb()
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (2/$numberOfActions *100) -Status "Connecting to the destination web, $DestinationWebUrl.";
$destinationSite = New-Object Microsoft.SharePoint.SPSite($DestinationWebUrl);
$destinationWeb = $destinationSite.OpenWeb()
Try
{
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (3/$numberOfActions *100) -Status "Getting the source list, $SourceListName.";
$sourceList = $web.Lists[$SourceListName];
$id = [Guid]::NewGuid()
$templateName = [String]::Format("{0}-{1}",$sourceList.Title,$id.ToString());
$templateFileName = $templateName;
$destinationListDescription = $sourceList.Description;
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (4/$numberOfActions *100) -Status "Saving the source list as a temmplate.";
$sourceList.SaveAsTemplate($templateFileName, $templateName, $sourceList.Description, $true)
if([String]::IsNullOrEmpty($DestinationListName)){$DestinationListName = $SourceListName;}
$listTemplate = $site.GetCustomListTemplates($web)[$templateName]
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (5/$numberOfActions *100) -Status "Creating a new list ($DestinationListName) in the $DestinationWebUrl site.";
$destinationWeb.Lists.Add($destinationListName, $destinationListDescription, $listTemplate) | out-null;
$destinationWeb.Update()
$listTemplates = $site.RootWeb.Lists["List Template Gallery"]
$lt = $listTemplates.Items | ?{$_.Title -eq $templateName}
if($lt -ne $null){$lt.Delete();}
write-host "The list $SourceListName has been copied to $DestinationWebUrl" -foregroundcolor Green
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (6/$numberOfActions *100) -Status "The list $SourceListName has been copied to $DestinationWebUrl";
Sleep 3;
}
Catch
{
Write-Progress -Id 1 -ParentId 0 -Activity "Copying list from site $SourceWebUrl to $DestinationWebUrl" -PercentComplete (6/$numberOfActions *100) -Status "Failed to copy the list $SourceListName"
Sleep 3
Write-Host "An error occurred: $_"
}
Finally
{
if($web -ne $null){$web.Dispose()}
if($site -ne $null){$site.Dispose()}
if($destinationWeb -ne $null){$destinationWeb.Dispose()}
if($destinationSite -ne $null){$destinationSite.Dispose()}
}
}
Importer la fonction
Copiez la fonction en entier dans une fenêtre "SharePoint Management Shell" (PowerShell). Vous pouvez alors appelez la fonction comme toute autre fonction.
Sinon, sauvegardez la fonction en tant que script Windows PowerShell (voir CopySPList.ps1 ), puis importez le script dans une fenêtre "SharePoint Management Shell" (PowerShell).
Import-Module C:\Scripts\CopySPList.ps1
Exemples d'utilisation de la fonction
Exemple 1: Get Help
get-help Copy-SPList -Detailed
Exemple 2: Copier la bibliothèque de documents "SecretDocuments" à partir du site "http://devmy101" vers le site "http://devmy101/moresecure", en conservant le même nom de liste.
Copy-SPList -SourceWebUrl "http://devmy101" -SourceListName "SecretDocuments" -DestinationWebUrl "http://devmy101/moresecure"
Exemple 3: Copier la bibliothèque de documents "SecretDocuments" à partir du site "http://devmy101" vers le site "http://devmy101/moresecure", en changeant le nom de la liste par "NotSoSecretDocuments".
Copy-SPList -SourceWebUrl "http://devmy101" -SourceListName "SecretDocuments" -DestinationWebUrl "http://devmy101/lesssecure" -DestinationListName "NotSoSecretDocuments"
Exemple 4: Créer une copie de la bibliothèque de documents "SecretDocuments" dans le même site "http://devmy101", avec comme nom "ACopyOfTheSecretDocuments".
Copy-SPList -SourceWebUrl "http://devmy101" -SourceListName "SecretDocuments" -DestinationWebUrl "http://devmy101" -DestinationListName "ACopyOfTheSecretDocuments"
Voir Aussi
Autres langues
Cet article est également disponible dans les langues suivantes :