Get-SPWebApplication

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

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

Syntax

Get-SPWebApplication
   [[-Identity] <SPWebApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-IncludeCentralAdministration]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Get-SPWebApplication werden alle Webanwendungen zurückgegeben, die mit dem durch den Identity -Parameter angegebenen Bereich übereinstimmen. Bei dem Identity -Parameter kann es sich um den Namen, die URL oder die GUID der Webanwendung handeln. Wenn kein Identity-Parameter angegeben wird, werden alle Webanwendungen zurückgegeben.

Die Webanwendung für die Zentraladministration wird nur zurückgegeben, wenn deren exakte Identität oder das IncludeCentralAdministration-Flag angegeben wird.

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

Beispiele

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

$w = Get-SPWebApplication https://sitename

In diesem Beispiel wird die Webanwendung für https://sitename abgerufen und in einer Variablen gespeichert.

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

Get-SPWebApplication -IncludeCentralAdministration | Where { $_.DefaultServerComment -eq "SharePoint Central Administration v4"} | Format-List *

In diesem Beispiel werden alle öffentlichen Eigenschaften der Webanwendung für die SharePoint Central Administration in Listenformat angezeigt.

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

-Identity

Gibt den Namen, die URL oder die GUID der Webanwendung an.

Der Typ muss eine gültige URL im Format https://server_name, eine GUID im Format 1234-5678-9876-0987 oder ein gültiger Name im Format SPWebApplication - 1212 sein.

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

-IncludeCentralAdministration

Enthält in der Sammlung von Webanwendungen, die zurückgegeben werden können, die Webanwendung für die Zentraladministration. Der Parameter IncludeCentral Administration muss dennoch allen anderen angegebenen Filtern entsprechen.

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