Get-SPSite

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

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

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

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

-CompatibilityLevel

Spécifie la version des 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 ou SharePoint Server. 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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-ContentDatabase

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).

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

-Filter

Spécifie le bloc de script du filtre côté serveur à appliquer.

Le type doit être un nom de filtre et une valeur valides sous la forme de l’opérateur> {$_PropertyName <« filterValue"}.

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

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 l'URL ou le GUID de la collection de sites à obtenir.

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

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

-Limit

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.

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

-NeedsB2BUpgrade

Spécifie si le site doit être mis à niveau.

Les valeurs valides sont True et False.

Type:	SwitchParameter
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

-SiteSubscription

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

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

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

-WebApplication

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 https://server_name, un GUID valide (par exemple 12345678-90ab-cdef-1234-567890bcdefgh) ou le nom de l'application web (par exemple WebApplication1212).

Type:	SPWebApplicationPipeBind
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

Partager via