Uninstall-SPSolution

撤銷已部署的 SharePoint 解決方案。

Syntax

Uninstall-SPSolution
         [-Identity] <SPSolutionPipeBind>
         [-AllWebApplications]
         [-AssignmentCollection <SPAssignmentCollection>]
         [-Confirm]
         [-CompatibilityLevel <String>]
         [-Language <UInt32>]
         [-Local]
         [-Time <String>]
         [-WhatIf]
         [<CommonParameters>]
Uninstall-SPSolution
         [-Identity] <SPSolutionPipeBind>
         -WebApplication <SPWebApplicationPipeBind>
         [-AssignmentCollection <SPAssignmentCollection>]
         [-Confirm]
         [-CompatibilityLevel <String>]
         [-Language <UInt32>]
         [-Local]
         [-Time <String>]
         [-WhatIf]
         [<CommonParameters>]

Description

此 Cmdlet 包含一個以上的參數集。 您可能只會使用到一個參數集中的參數,而且您無法合併不同參數集中的參數。 如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集

Cmdlet Uninstall-SPSolution 會撤銷已部署的 SharePoint 解決方案,以準備將它從伺服器陣列中完全移除。 此 Cmdlet 會從前端 Web 服務器移除檔案。 使用 Cmdlet Remove-SPSolution 從伺服陣列的方案存放區中刪除方案套件;請務必在執行 Uninstall-SPSolution 之後才使用 Remove-SPSolution Cmdlet。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

------------------範例------------------

Uninstall-SPSolution -Identity contoso_solution.wsp

此範例會撤銷已部署的 SharePoint 解決方案 contoso_solution.wsp。

參數

-AllWebApplications

指定要解除安裝之伺服器陣列中所有 SharePoint Web 應用程式的新 SharePoint 解決方案。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

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

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

指定是否根據 CompatibilityLevel 從特定的版本目錄解除安裝解決方案。 如果未指定此參數,預設行為是根據解決方案 cab 檔案的資訊清單中所追蹤的版本,只從版本目錄解除安裝解決方案。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

指定要解除安裝的 SharePoint 解決方案。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的 SharePoint 解決方案名稱 (例如 SPSolution1),或有效之 SPSolution 物件的執行個體。

Type:SPSolutionPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Language

解除安裝指定語言的語言套件。

此類型必須是有效的語言識別碼;例如,1033。

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Local

從使用中的伺服器電腦中解除安裝解決方案。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Time

指定要解除安裝解決方案的時間。 預設值是立即撤銷。

此類型必須是格式為 2010,12,05 的有效 DateTime 值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

解除安裝指定 SharePoint Web 應用程式的 SharePoint 解決方案。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的 SharePoint Web 應用程式名稱 (例如 MyOfficeApp1),或有效之 SPWebApplication 物件的執行個體。

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令: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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019