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.

The Get-SPSite cmdlet returns either a single site that matches the Identity parameter, or all the sites that match the Filter parameter for the specified scope. The scopes are the WebApplication, ContentDatabase , and SiteSubscription parameters. If none of these scopes is provided, the scope is the farm. If the scope is specified with no Filter parameter, all sites in that scope are returned.

The Identity parameter supports providing a partial URL that ends in a wildcard character (*). All site collections that match this partial URL for the specified scope are returned. Additionally, if the Regex parameter is provided, the Identity parameter is treated as a regular expression and any site collection with a URL provided in the given scope that matches the expression is returned.

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.

It is important to note that every site collection that the Get-SPSite cmdlet returns is automatically destroyed at the end of the pipeline. To store the results of Get-SPSite in a local variable, use the Start-SPAssignment and Stop-SPAssignment cmdlets to avoid memory leaks.

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-sites dans la collection de sites à https://<site name>.

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

The previous example uses the Global method of assignment collection. The Global method is easy to use but the contents of this object grows quickly. Be careful not to run a Get-SPSite command that returns many results while global assignment is enabled.

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

- Identité

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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
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
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
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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Filtrer

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.

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

-Limite

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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition