Get-SPWeb

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Gibt alle Unterwebsites zurück, die mit den angegebenen Suchkriterien übereinstimmen.

Syntax

Get-SPWeb
   [[-Identity] <SPWebPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-Site <SPSitePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Get-SPWeb werden alle Unterwebsites zurückgegeben, die mit dem durch den Identity-Parameter angegebenen Bereich übereinstimmen. Es werden alle Unterwebsites zurückgegeben, die die Kriterien erfüllen.

Der Identity-Parameter kann die vollständige URL oder ein relativer Pfad sein. Wenn Sie einen relativen Pfad angeben, müssen Sie auch den Site-Parameter angeben, um die Websitesammlung zu identifizieren, von der die Unterwebsite zurückgegeben werden soll.

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

Der Parameter Filter ist ein serverseitiger Filter für bestimmte Unterwebsiteeigenschaften, die in der Inhaltsdatenbank gespeichert sind. Ohne den Filter-Parameter ist das Filtern nach diesen Eigenschaften ein langsamer Prozess. Diese Unterwebsiteeigenschaften sind Vorlage und Titel. Der Parameter Filter ist ein Skriptblock, der dieselbe Syntax wie eine Where-Object-Anweisung verwendet, aber serverseitig ausgeführt wird, um schnellere Ergebnisse zu erzielen.

Jede Websitesammlung, die von dem Cmdlet Get-SPWeb zurückgegeben wird, wird am Ende der Pipeline automatisch entfernt. Zum Speichern der Ergebnisse von Get-SPWeb 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-SPWeb -site https://sitename/sites/site1

In diesem Beispiel werden alle Unterwebsites in einer angegebenen Websitesammlung zurückgegeben.

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

Get-SPWeb -Site https://sitename/sites/site1  -filter {$_.Template -eq "STS#0"}

In diesem Beispiel werden alle Unterwebsites zurückgegeben, von denen die Vorlage "STS#0" verwendet wird.

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

Start-SPAssignment -Global
$w = Get-SPWeb https://sitename
$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global

In diesem Beispiel wird dargestellt, wie eine Unterwebsite als Variable gespeichert wird und Objektmodellmethoden für das SPAssignment -Objekt aufgerufen werden.

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

-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

-Filter

Gibt den serverseitigen Filter an, der für den angegebenen Bereich verwendet werden soll.

Der Typ muss ein gültiger Filter im Format {filterName-Operator <> "filterValue"}sein.

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 den Namen oder die vollständige oder teilweise URL der Unterwebsite an. Wenn Sie einen relativen Pfad verwenden, müssen Sie den Parameter Site angeben.

Eine gültige URL im Format https://server_name oder ein relativer Pfad im Format /SubSites/MySubSite.

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

-Limit

Schränkt die maximale Anzahl von zurückzugebenden Unterwebsites ein. Der Standardwert lautet 200. Damit alle zurückgegeben werden, geben Sie ALL ein.

Bei dem Typ muss es sich um eine gültige Zahl größer 0 oder um ALL handeln.

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

-Regex

Gibt an, dass die URL, die vom Identity -Parameter angegeben wird, als regulärer Ausdruck behandelt wird.

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

-Site

Gibt die URL oder GUID der Websitesammlung an, von der die Unterwebsites aufgelistet werden.

Bei dem Typ muss es sich um eine gültige URL im Format https://server_name, eine GUID im Format 1234-5678-9807 oder ein SPSite -Objekt handeln.

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