Remove-SPManagedPath

 

適用版本: SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間: 2015-03-09

從指定的主機標頭或 Web 應用程式中,刪除指定的受管理路徑。

Syntax

Remove-SPManagedPath [-Identity] <SPPrefixPipeBind> -WebApplication <SPWebApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Remove-SPManagedPath [-Identity] <SPPrefixPipeBind> -HostHeader <SwitchParameter> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

詳細描述

Remove-SPManagedPath Cmdlet 會從主機標頭或 Web 應用程式中,刪除 Identity 參數所指定的受管理路徑。Identity 必須是要刪除之受管理路徑的部分 URL。

若您使用的是主機標頭,請指定 HostHeader 參數。若要刪除 HostHeader 受管理路徑,請提供 HostHeader 參數;否則,您必須指定包含要刪除之受管理路徑的 Web 應用程式。

Parameters

參數 必要 類型 描述

Identity

必要

Microsoft.SharePoint.PowerShell.SPPrefixPipeBind

指定要刪除的受管理路徑名稱。例如,在 URL http://sitename/sites/site1 中,"sites" 是受管理路徑的名稱。

HostHeader

必要

System.Management.Automation.SwitchParameter

指定 Identity 為主機標頭受管理路徑。

WebApplication

必要

Microsoft.SharePoint.PowerShell.WebApplicationPipeBind

指定所要刪除之受管理路徑所在之 Web 應用程式的身分識別。此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的 Web 應用程式名稱 (例如 WebApplication1212),或格式為 WebApp2423 的有效名稱。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

輸入類型

傳回類型

Example

----------------------範例 1----------------------------

Remove-SPManagedPath "sites" -HostHeader

此範例會從 HostHeader 受管理路徑清單中,移除 sites 受管理路徑。

可能會出現提示,指示先執行前一個範例,視本機系統的確認等級而定。

------------------範例 2-----------------------

Get-SPWebApplication | Remove-SPManagedPath "personal" -confirm:$false

此範例會移除伺服器陣列之所有 Web 應用程式中的 personal 受管理路徑。此命令不會顯示確認提示。

See Also

Reference

Get-SPManagedPath
New-SPManagedPath