Get-SPSite

Syntax

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

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, consultez les Jeux de paramètres des applets de commande.

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 un processus lent. Ces propriétés de collection de sites sont Owner, SecondaryContact et LockState. 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é sur le serveur pour obtenir 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.

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

Cet exemple obtient la collection de titres de sous-site web dans la collection de sites à https://< nom> du site.

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

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

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 https://<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 https://<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 "https://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 https://<site name>/sites/teams/* -Limit 100

Cet exemple obtient jusqu’à 100 des sites sous l’URL https://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.

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

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

Paramètres

-AssignmentCollection

-CompatibilityLevel

-Confirm

-ContentDatabase

-Filter

-Identity

-Limit

-NeedsB2BUpgrade

-Regex

-SiteSubscription

-WebApplication

-WhatIf