Get-SPSite
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 TitleCet 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, SecondaryContactCet 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 -GlobalCet 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 $GCCet 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" -RegexCet 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 100Cet 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 14Cet 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 |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour