Get-SPManagedPath

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

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

Syntax

Get-SPManagedPath
   [[-Identity] <SPPrefixPipeBind>]
   [-HostHeader]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

Get-SPManagedPath
   [[-Identity] <SPPrefixPipeBind>]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [<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-SPManagedPath gibt den verwalteten SharePoint-Pfad zurück, der der angegebenen Identität für eine Webanwendung, Websitesammlung oder für alle Websitesammlungen mit Hostnamen entspricht. Wird kein Parameter Identity angegeben, werden alle verwalteten Pfade für den gegebenen Bereich zurückgegeben.

Websites mit Hostnamen (unabhängig von der Webanwendung, in der sie enthalten sind) verwenden einen einzigen Satz verwalteter Pfade. Verwenden Sie den HostHeader-Parameter, um verwaltete Pfade im Bereich von Websitesammlungen mit Hostnamen zurückzugeben.

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-SPManagedPath -WebApplication https://sitename

In diesem Beispiel werden alle verwalteten Pfade für die angegebene Webanwendung zurückgegeben.

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

Get-SPManagedPath -identity "Sites" -HostHeader

In diesem Beispiel wird der verwaltete Pfad Websites aus den verwalteten Pfaden im Bereich der Hostsammlungen abgerufen.

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

-HostHeader

Falls angegeben, gelten die zurückgegebenen verwalteten Pfade für die websites mit Hostnamen in der Farm.

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

-Identity

Gibt die URL oder GUID des abzurufenden verwalteten Pfads an.

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:	SPPrefixPipeBind
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

Gibt die URL oder die GUID der Webanwendung an, aus der der verwaltete Pfad abgerufen werden soll.