Get-SPWeb

Syntax

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

Description

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 un processus 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 est exécuté côté serveur pour obtenir 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 les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

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

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

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

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

Get-SPWeb -Site https://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 https://sitename
$w.set_SiteLogoUrl("https://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.

Paramètres

-AssignmentCollection

-Confirm

-Filter

-Identity

-Limit

-Regex

-Site

-WhatIf