Convert-SPWebApplication

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

轉換 Web 應用程式的驗證模式。

Syntax

Convert-SPWebApplication
       -Identity <SPWebApplicationPipeBind>
       -From <String>
       -To <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Force]
       [-RetainPermissions]
       [-Database <SPContentDatabase>]
       [-MapList <String>]
       [-SiteSubsriptionId <Guid>]
       [-SkipPolicies]
       [-SkipSites]
       [-SourceSkipList <String>]
       [-TrustedProvider <SPTrustedIdentityTokenIssuerPipeBind>]
       [-LoggingDirectory <String>]
       [<CommonParameters>]

Description

使用 Convert-SPWebApplication Cmdlet 將 Web 應用程式的驗證模式轉換為 Windows 宣告驗證模式，並將內容資料庫中的使用者帳戶移轉至宣告編碼值。

保留許可權時，只有當來源帳戶已啟用且可由 SharePoint 查詢時，才會轉換網站內的使用者。例如，如果在傳統 Windows 到 Windows 宣告轉換之前刪除或停用 Active Directory 帳戶，資料庫中的帳戶將不會更新為宣告格式。

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

範例

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

Convert-SPWebApplication -Identity "https://<webappurl>" -To Claims -RetainPermissions

此範例會將 Identity 參數指定的 Web 應用程式轉換為使用宣告驗證模式。

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

Convert-SPWebApplication -Identity "https://<webappurl>" -From Legacy -To Claims -RetainPermissions

本範例會將 Identity 參數所指定的 Web 應用程式從傳統Windows 驗證轉換為宣告驗證模式，同時保留許可權。套用安全性更新 MS04-022 或套用 SharePoint Server 2013 的 2014 年 4 月累積更新之後，需要 -From 參數。這是所有 SharePoint Server 2016 版本的必要專案。

參數

-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 Subscription Edition

-Database

指定要移轉的內容資料庫名稱。

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

-Force

強制轉換 Web 應用程式。

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

-From

指定要從中轉換的驗證方法。

此參數的有效值如下所示。

舊版、Claims-Windows、Claims-Trusted-Default

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

-Identity

指定您要轉換之 Web 應用程式的 URL，例如：https://mysite/app1

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

-LoggingDirectory

指定將寫入移轉結果詳細資訊記錄的目錄。

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

-MapList

以下列格式指定包含為數據列清單的檔案：user-key、migrated-user-name、migrated-user-key。

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

-RetainPermissions

指定用來執行 Cmdlet 的帳戶，並保留 Web 應用程式中的權限。

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

-SiteSubsriptionId

指定網站訂用帳戶的 GUID。

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

-SkipPolicies

指定不會移轉 SPWebApplication 安全性原則。

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

-SkipSites

指定將不會移轉 SPWebApplication 的 SPSites。

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

-SourceSkipList

以下列格式指定包含為數據列清單的檔案：使用者金鑰。

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

-To

指定要轉換成的驗證方法。