Partager via

Get-SPSiteAdministration

Module:
SharePointServer module

Renvoie un objet d'administration de site qui permet aux administrateurs de batteries de serveurs d'afficher certaines informations sur des collections de sites auxquelles ils n'ont pas accès.

Syntaxe

AllSitesInIdentity 

Get-SPSiteAdministration
    [-Identity] <SPSiteAdministrationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-Regex]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInContentDB 

Get-SPSiteAdministration
    -ContentDatabase <SPContentDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInSiteSubscription 

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

AllSitesInWebApplication 

Get-SPSiteAdministration
    [-AssignmentCollection <SPAssignmentCollection>]
    [-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-SPSiteAdminitration renvoie un objet d’administration de site qui permet aux administrateurs de batteries de serveurs d’afficher certaines informations sur des collections de sites auxquelles ils n’ont pas accès.

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-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}

Cet exemple obtient un sous-ensemble de données de tous les sites de la base de données de contenu avec l'URL b399a366-d899-4cff-8a9b-8c0594ee755f (l'administrateur de la batterie de serveurs ne nécessite pas l'accès). Cette commande utilise la propriété calculée Storage pour afficher la valeur maximale de stockage de la base de données de contenu.

EXEMPLE 2

Start-SPAssignment -Global
$s = Get-SPSiteAdministration -Identity https://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global

Cet exemple obtient les collections de sites spécifiées par le paramètre Identity et insère les résultats dans la variable s. Cet exemple utilise la méthode Global de nettoyage de la mémoire. Cette méthode est plus facile à utiliser mais grossit rapidement. N’exécutez pas une commande Get-SPSite qui renvoie de nombreux résultats alors que l’affectation globale est activée.

EXEMPLE 3

C:\PS>$GC = Start-SPAssignment
$Sites = $GC | Get-SPSiteAdministration -Filter {$_.Owner -eq "DOMAIN\JDoe"} -Limit 50
Stop-SPAssignment $GC

Cet exemple obtient les 50 premiers sites détenus par l'utilisateur DOMAIN\JDoe via une requête côté serveur et affecte les sites renvoyés à une variable locale. Cette commande utilise des méthodes avancées d’affectation de collection.

EXEMPLE 4

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}

Cette commande renvoie la somme de l’utilisation de l’espace disque de tous les sites de l’application web spécifiée.

EXEMPLE 5

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL

Cet exemple obtient les URL de toutes les collections de sites d’une application web.

EXEMPLE 6

Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex

Cet exemple renvoie tous les sites qui correspondent à l'expression régulière donnée. Les guillemets qui encadrent la valeur spécifiée pour le paramètre Identity sont requis si vous utilisez l’indicateur Regex.

EXEMPLE 7

Get-SPSite "https://sitename/sites/teams/*" -Limit 100

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

Paramètres

-AssignmentCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ContentDatabase

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l'URL (complète ou partielle) ou le GUID de la collection de sites à récupérer.

Le type doit être une URL valide au format https://server_name, ou un GUID au format 1234-456-987fg.

Propriétés du paramètre

Type:SPContentDatabasePipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AllSitesInContentDB
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Filter

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Le type doit être un nom de filtre valide et une valeur au format { $_ PropertyName <, opérateur > « filterValue"}}

Propriétés du paramètre

Type:ScriptBlock
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie l'URL (complète ou partielle) ou le GUID de la collection de sites à récupérer.

Le type doit être une URL valide au format https://server_name, ou un GUID au format 1234-456-987fg.

Propriétés du paramètre

Type:SPSiteAdministrationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AllSitesInIdentity
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Limit

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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. Choisissez TOUS pour renvoyer toutes les collections de sites pour l'étendue donnée.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Regex

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Lorsque ce commutateur est activé, l'URL spécifiée pour le paramètre Identity est traitée comme une expression régulière.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AllSitesInIdentity
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SiteSubscription

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie le groupe de sites à partir duquel obtenir les collections de sites.

Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, un site SharePoint (objet ou URL) d'une collection de sites membre de l'abonnement au site ou une instance d'un objet SiteSubscription valide.

Propriétés du paramètre

Type:SPSiteSubscriptionPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AllSitesInSiteSubscription
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WebApplication

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPWebApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AllSitesInWebApplication
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.