Get-SPSite

  • Referenz
Modul:
sharepoint-server
Gilt für::
SharePoint Server Subscription Edition

Gibt alle Websitesammlungen zurück, die mit den angegebenen Kriterien übereinstimmen.

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

Beschreibung

Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Das Cmdlet Get-SPSite gibt eine einzelne Website zurück, die mit dem Parameter Identity übereinstimmt, oder alle Websites, die mit dem Parameter Filter für den angegebenen Bereich übereinstimmen. Die Bereiche sind die Parameter WebApplication, ContentDatabase und SiteSubscription. Wenn keiner dieser Bereiche angegeben wird, gilt die Farm als Bereich. Wenn der Bereich ohne den Parameter Filter angegeben wird, werden alle Websites in diesem Bereich zurückgegeben.

Der Parameter Identity unterstützt die Angabe einer Teil-URL, die mit einem Platzhalterzeichen (*) endet. Alle Websitesammlungen, die mit der Teil-URL für den angegebenen Bereich übereinstimmen, werden zurückgegeben. Wenn der Parameter Regex angegeben wird, wird der Parameter Identity als regulärer Ausdruck behandelt, und es werden alle Websitesammlungen mit einer URL im angegebenen Bereich zurückgegeben, die mit dem Ausdruck übereinstimmt.

Der Parameter Filter ist ein serverseitiger Filter für bestimmte Websitesammlungseigenschaften, die in der Inhaltsdatenbank gespeichert sind. Ohne den Filter-Parameter ist das Filtern nach diesen Eigenschaften ein langsamer Prozess. Diese Websitesammlungseigenschaften sind Owner, SecondaryContact und LockState. Der Parameter Filter ist ein Skriptblock, der die gleiche Syntax wie eine Where-Object-Anweisung verwendet, aber auf dem Server ausgeführt wird, um schnellere Ergebnisse zu erzielen.

Gültige Werte für LockState sind Unlock, NoAdditions, ReadOnly und NoAccess.

Jede Websitesammlung, die von dem Cmdlet Get-SPSite zurückgegeben wird, wird am Ende der Pipeline automatisch entfernt. Zum Speichern der Ergebnisse von Get-SPSite in einer lokalen Variablen müssen die Cmdlets Start-SPAssignment und Stop-SPAssignment verwendet werden, damit Speicherverluste vermieden werden.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

------------------BEISPIEL 1-----------------------

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

In diesem Beispiel wird die Auflistung von Unterwebtiteln in der Websitesammlung unter https://< Websitename> abgerufen.

------------------BEISPIEL 2---------------------

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

Dieses Beispiel ruft eine Datenuntermenge aus allen Websites in der Inhaltsdatenbank b399a366-d899-4cff-8a9b-8c0594ee755f ab.

------------------BEISPIEL 3---------------------

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

In diesem Beispiel werden die Websites abgerufen, die durch den Parameter Identity angegeben werden, und die Ergebnisse werden in die Variable s eingefügt.

Das vorherige Beispiel verwendet die Methode Global der Zuweisungsauflistung. Die Methode Global ist einfach zu verwenden, der Inhalt dieses Objekts wächst jedoch sehr schnell. Führen Sie keinen Get-SPSite-Befehl aus, mit dem viele Ergebnisse zurückgegeben werden, während die globale Zuweisung aktiviert ist.

------------------BEISPIEL 4---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

Dieses Beispiel ruft die ersten 50 Websites ab, deren Besitzer der Benutzer DOMAIN\JDow ist. Zu diesem Zweck wird eine serverseitige Abfrage verwendet, und sie werden einer lokalen Variablen zugewiesen.

Dieses Beispiel verwendet erweiterte Zuweisungsauflistungsmethoden.

------------------BEISPIEL 5---------------------

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

Dieses Beispiel zeigt einen Befehl, der den Gesamtwert der Verwendung des Speicherplatzes auf dem Datenträger für alle Websites in einer angegebenen Webanwendung zurückgibt.

------------------BEISPIEL 6---------------------

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

In diesem Beispiel werden alle Websites zurückgegeben, die mit dem angegebenen regulären Ausdruck übereinstimmen.

Die Anführungszeichen für den Parameter Identity sind erforderlich, wenn der Parameter Regex verwendet wird.

------------------BEISPIEL 7---------------------

Get-SPSite https://<site name>/sites/teams/* -Limit 100

In diesem Beispiel werden bis zu 100 der Websites unter der URL abgerufen. https://sitename/sites/teams.

------------------BEISPIEL 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

Dieses Beispiel ruft den durch eine Websitesammlung belegten Speicherplatz mithilfe des Speicherfelds der Eigenschaft .UsageInfo ab.

------------------BEISPIEL 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

In diesem Beispiel werden alle Websitesammlungen im SharePoint Server-Modus zurückgegeben.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

-CompatibilityLevel

Gibt die Version von Vorlagen an, die beim Erstellen eines neuen SPSite-Objekts verwendet werden müssen. Dieser Wert bestimmt den Ausgangswert von CompatibilityLevel für die Websitesammlung. Die Werte für diesen Parameter können entweder SharePoint Server oder SharePoint Server sein. Wird dieser Parameter nicht angegeben, wird die Kompatibilitätsstufe abhängig von der Einstellungen von SiteCreationMode standardmäßig auf die höchstmögliche Version für die Webanwendung festgelegt.

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

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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

Gibt die GUID der Inhaltsdatenbank an, aus der Websitesammlungen aufgelistet werden.

Der Typ muss ein gültiger Datenbankname in der Form SPInhaltsDB01 oder eine gültige GUID (z. B. 12345678-90ab-cdef-1234-567890bcdefgh) sein.

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

-Filter

Gibt den Skriptblock des anzuwendenden serverseitigen Filters an.

Der Typ muss ein gültiger Filtername und -wert im Format {$_PropertyName <Operator> "filterValue"} sein.

Gültige Operatoren sind EQ, NE, LIKE und 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

Gibt die URL oder GUID der abzurufenden Websitesammlung an.

Der Typ muss eine gültige URL im Format https://server_name oder https://server_name/sites/sitename oder eine gültige GUID (z. B. 12345678-90ab-cdef-1234-567890bcdefgh) sein.

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

-Limit

Schränkt die maximale Anzahl von zurückzugebenden Websitesammlungen ein. Der Standardwert lautet 200.

Bei dem Typ muss es sich um eine positive Zahl handeln. Geben Sie ALL an, wenn alle Websitesammlungen für den angegebenen Bereich zurückgegeben werden sollen.

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

-NeedsB2BUpgrade

Gibt an, ob die Website aktualisiert werden muss.

Die gültigen Werte sind True und 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

Wird dieser Parameter verwendet, wird die für den Parameter Identity angegebene URL als regulärer Ausdruck behandelt.

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

-SiteSubscription

Gibt das Websiteabonnement an, aus dem Websitesammlungen abgerufen werden sollen.

Der Typ muss eine gültige URL im Format https://server_name oder eine gültige GUID (z. B. 12345678-90ab-cdef-1234-567890bcdefgh) sein.

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

-WebApplication

Gibt die URL, die GUID oder den Namen der Webanwendung an, aus der Websites aufgelistet werden sollen.

Bei dem Typ muss es sich um eine gültige URL im Format https://server_name, eine gültige GUID (z. B. 12345678-90ab-cdef-1234-567890bcdefgh) oder den Namen einer Webanwendung (z. B. WebApplication1212) handeln.

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

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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