Partager via


Get-SPWeb

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

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

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.

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Filter

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

Le type doit être un filtre valide sous la forme {filterName <, opérateur> « filterValue"}.

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

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 https://server_name ou chemin d'accès relatif au format /SubSites/MySubSite.

Type:SPWebPipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Limit

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Regex

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Site

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 https://server_name, un GUID au format 1234-5678-9807 ou un objet SPSite.

Type:SPSitePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition