Get-SPSite

 

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

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

Renvoie toutes les collections de sites correspondant aux critères spécifiés.

Get-SPSite [-AssignmentCollection <SPAssignmentCollection>] [-CompatibilityLevel <Int32>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-WebApplication <SPWebApplicationPipeBind>] [-WhatIf [<SwitchParameter>]]
Get-SPSite [-Identity] <SPSitePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-CompatibilityLevel <Int32>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-Regex <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Get-SPSite -ContentDatabase <SPContentDatabasePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-CompatibilityLevel <Int32>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-WhatIf [<SwitchParameter>]]
Get-SPSite -SiteSubscription <SPSiteSubscriptionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-CompatibilityLevel <Int32>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-WhatIf [<SwitchParameter>]]

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, voir la rubrique relative aux jeux de paramètres de cmdlet.

L’applet de commande Get-SPSite renvoie soit un seul site correspondant au paramètre Identity, soit tous les sites correspondant au paramètre Filter pour l’étendue spécifiée. Les étendues sont les paramètres WebApplication, ContentDatabase et SiteSubscription. Si aucune de ces étendues n’est fournie, l’étendue est la batterie. Si l’étendue est spécifiée sans paramètre Filter, tous les sites de cette étendue sont renvoyés.

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 (*). Toutes les collections de sites qui correspondent à cette URL partielle pour l’étendue spécifiée sont renvoyées. De plus, si le paramètre Regex est spécifié, le paramètre Identity est traité comme une expression régulière, et chaque collection de sites dont l’URL fait partie de l’étendue donnée et correspond à l’expression est renvoyée.

Le paramètre Filter est un filtre côté serveur pour certaines propriétés de collection de sites 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 collection de sites sont Owner, SecondaryOwner et LockState. 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 sur le serveur pour des résultats plus rapides.

Les valeurs valides pour LockState sont : Unlock, NoAdditions, ReadOnly, NoAccess.

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

SharePoint Management Shell

 

Paramètre Obligatoire Type Description

Identité

Obligatoire

Microsoft.SharePoint.PowerShell.SPSitePipeBind

Spécifie l’URL ou le GUID de la collection de sites à obtenir.

Le type doit être une URL valide au format http://nom_serveur ou http://nom_serveur/sites/nom_site, ou un GUID valide (par exemple 12345678-90ab-cdef-1234-567890bcdefgh).

ContentDatabase

Requis

Microsoft.SharePoint.PowerShell.SPContentDatabasePipeBind

Spécifie le GUID de la base de données de contenu à partir de laquelle répertorier les collections de sites.

Le type doit correspondre à un nom de base de données valide au format SPContentDB01, ou un GUID valide (par exemple 12345678-90ab-cdef-1234-567890bcdefgh).

SiteSubscription

Obligatoire

Microsoft.SharePoint.PowerShell.SPSiteSubscriptionPipeBind

Spécifie l’inscription de sites à partir de laquelle obtenir les collections de sites.

Le type doit être une URL valide au format http://nom_serveur, ou un GUID valide (par exemple 12345678-90ab-cdef-1234-567890bcdefgh).

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.

CompatibilityLevel

Facultatif

System.Int32

Spécifie la version de modèles à utiliser lors de la création d’un objet SPSite. Cette valeur définit la valeur initiale de CompatibilityLevel pour la collection de sites. Les valeurs de ce paramètre peuvent être SharePoint Server 2010 ou SharePoint Server 2013. Lorsque ce paramètre n’est pas spécifié, CompatibilityLevel sera par défaut la version la plus élevée possible pour l’application web, en fonction du paramètre SiteCreationMode.

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 bloc de script du filtre côté serveur à appliquer.

Le type doit correspondre à un nom et une valeur de filtre valides au format {$_PropertyName <operator> "filterValue"}.

Les opérateurs valides sont : EQ, NE, LIKE, NOTLIKE.

Limit

Facultatif

System.String

Limite le nombre maximal de collections de sites à renvoyer. La valeur par défaut est 200.

Le type doit correspondre à un nombre non négatif valide. Spécifiez ALL pour renvoyer toutes les collections de sites de l’étendue donnée.

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.

WebApplication

Facultatif

Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind

Spécifie l’URL, le GUID ou le nom de l’application web à partir de laquelle répertorier les sites.

Le type doit être une URL valide au format http://nom_serveur, un GUID valide (par exemple 12345678-90ab-cdef-1234-567890bcdefgh) ou le nom de l’application web (par exemple WebApplication1212).

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-SPSite 'http://<site name>' | Get-SPWeb -Limit All | Select Title

Cet exemple extrait la collection de titres de sous-sites de la collection de sites à l’adresse http://<site name>.

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

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryOwner

Cet exemple extrait un sous-ensemble de données de tous les sites de la base de données de contenu b399a366-d899-4cff-8a9b-8c0594ee755f.

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

Start-SPAssignment -Global
$s = Get-SPSite -Identity http://<MyApp>/Sites/Site1
$s.Url
Stop-SPAssignment -Global

Cet exemple extrait les sites spécifiés par le paramètre Identity et insère les résultats dans la variable s.

L’exemple précédent utilise la méthode Global d’affectation de collection. La méthode Global est simple à utiliser mais le contenu de cet objet croît rapidement. Veillez à ne pas exécuter de commande Get-SPSite qui renvoie un grand nombre de résultats lorsque l’affectation globale est activée.

------------------EXEMPLE 4---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

Cet exemple obtient les 50 premiers sites détenus par l’utilisateur DOMAIN\JDow au moyen d’une requête côté serveur et les affecte à une variable locale.

Cet exemple utilise des méthodes avancées d’affectation de collection.

------------------EXEMPLE 5---------------------

Get-SPWebApplication http://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

Cet exemple montre une commande qui renvoie la somme de l’espace disque utilisé pour tous les sites d’une application web donnée.

------------------EXEMPLE 6---------------------

Get-SPSite -Identity "http://localserver/(my|personal)/sites" -Regex

Cet exemple renvoie tous les sites qui correspondent à l’expression régulière donnée.

Les guillemets dans le paramètre Identity sont obligatoires lorsque vous utilisez le paramètre Regex.

------------------EXEMPLE 7---------------------

Get-SPSite http://<site name>/sites/teams/* -Limit 100

Cet exemple obtient jusqu’à 100 sites sous l’URL http://sitename/sites/teams.

------------------EXEMPLE 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

Cet exemple obtient le volume de stockage utilisé par une collection de sites en utilisant le champ de stockage de la propriété .UsageInfo.

------------------EXEMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

Cet exemple renvoie toutes les collections de sites en mode SharePoint Server 2010.

Afficher: