Freigeben über

Get-SPWeb

Modul:
SharePointServer module

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

Syntax

Default (Standardwert) 

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

C:\PS>$w = Get-SPWeb https://sitename

C:\PS>$w.set_SiteLogoUrl("https://PathToImage/test.jpg")

C:\PS>$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

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

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.

Parametereigenschaften

Typ:SPAssignmentCollection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

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

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.

Parametereigenschaften

Typ:ScriptBlock
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Identity

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

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.

Parametereigenschaften

Typ:SPWebPipeBind
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Limit

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

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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Regex

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Site

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

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.

Parametereigenschaften

Typ:SPSitePipeBind
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.