Get-SPWeb

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

Dernière rubrique modifiée :2015-03-09

Renvoie tous les sous-sites correspondant aux critères donnés.

Get-SPWeb [[-Identity] <SPWebPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-Regex <SwitchParameter>] [-Site <SPSitePipeBind>] [-WhatIf [<SwitchParameter>]]

L’applet de commande Get-SPWeb renvoie tous les sous-sites qui correspondent à l’étendue donnée par le paramètre Identity. Tous les sous-sites répondant à ces critères sont renvoyés.

Le paramètre Identity peut être l’URL complète ou un chemin d’accès relatif. Si vous spécifiez un chemin d’accès relatif, vous devez également spécifier le paramètre Site afin d’identifier la collection de sites à partir de laquelle le sous-site est renvoyé.

Le paramètre Identity prend également en charge la spécification d’une URL partielle qui se termine par un caractère générique (*). Tous les sous-sites qui correspondent à cette URL partielle pour l’étendue spécifiée sont renvoyés. De plus, si le paramètre Regex est spécifié, le paramètre Identity est traité comme une expression régulière, et chaque sous-site web dont l’URL fait partie de l’étendue donnée et correspond à l’expression est renvoyé.

Le paramètre Filter est un filtre côté serveur pour certaines propriétés de sous-site stockées dans la base de données de contenu. Sans le paramètre Filter, le filtrage sur ces propriétés est lent. Ces propriétés de sous-site sont Template et Title. Le paramètre Filter est un bloc de script qui utilise la même syntaxe qu’une instruction Where-Object, mais qui s’exécute côté serveur pour des résultats plus rapides.

Il est important de noter que chaque collection de sites renvoyée par l’applet de commande Get-SPWeb est automatiquement éliminée au terme du pipeline. Pour stocker les résultats de l’applet de commande Get-SPWeb dans une variable locale, utilisez les applets de commande Start-SPAssignment et Stop-SPAssignment afin d’éviter les fuites de mémoire.

Pour connaître les autorisations et les informations les plus récentes concernant Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne http://go.microsoft.com/fwlink/p/?LinkId=251831.

Paramètre Obligatoire Type Description

Identity

Facultatif

Microsoft.SharePoint.PowerShell.SPWebPipeBind

Spécifie le nom ou l’URL complète ou partielle du sous-site. Si vous utilisez un chemin d’accès relatif, vous devez spécifier le paramètre Site.

URL valide au format http://server_name ou chemin d’accès relatif au format /SubSites/MySubSite.

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Gère les objets de manière à optimiser leur libération. L’utilisation d’objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l’aide de l’objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu’ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

RemarqueRemarque :
Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

Filter

Facultatif

System.Management.Automation.ScriptBlock

Spécifie le filtre côté serveur à utiliser pour l’étendue spécifiée.

Le type doit être un filtre valide au format {filterName <operator> "filterValue"}.

Limit

Facultatif

System.String

Limite le nombre maximal de sous-sites à renvoyer. La valeur par défaut est 200. Pour renvoyer tous les sites, entrez TOUS.

Le type doit correspondre à un nombre valide supérieur à 0 ou TOUS.

Regex

Facultatif

System.Management.Automation.SwitchParameter

Spécifie si l’URL fournie par le paramètre Identity est traitée comme une expression régulière. .

Site

Facultatif

Microsoft.SharePoint.PowerShell.SPSitePipeBind

Spécifie l’URL ou le GUID de la collection de sites à partir de laquelle répertorier les sous-sites.

Le type doit être une URL valide au format http://server_name, un GUID au format 1234-5678-9807 ou un objet SPSite.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

------------------EXEMPLE 1-----------------------

Get-SPWeb -site http://sitename/sites/site1

Cet exemple renvoie tous les sous-sites web d’une collection de sites donnée.

------------------EXEMPLE 2-----------------------

Get-SPWeb -Site http://sitename/sites/site1  -filter {$_.Template -eq "STS#0"}

Cet exemple affiche tous les sous-sites qu’utilise le modèle "STS#0".

------------------EXEMPLE 3-----------------------

Start-SPAssignment -Global
$w = Get-SPWeb http://sitename
$w.set_SiteLogoUrl("http://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global

Cet exemple montre comment enregistrer un sous-site comme variable et comment appeler des méthodes de modèle d’objet sur l’objet SPAssignment.

Afficher: