Set-SPServer

模組:

SharePointServer module

變更伺服器的角色。

語法

Default (預設值)

Set-SPServer
    [-Identity] <SPServerPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Role <SPServerRole>]
    [-Status <SPObjectStatus>]
    [<CommonParameters>]

Description

Set-SPServer Cmdlet 會使用 Role 參數來變更伺服器陣列中伺服器的角色。 SharePoint Server 2016 中的新 Cmdlet，SharePoint Server 2019 用於 MinRole。

範例

例

Set-SPServer -Role SingleServerFarm

此範例會將伺服器變更為 SingleServerFarm 角色。

參數

-AssignmentCollection

適用：SharePoint Server 2016，SharePoint Server 2019

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

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

參數屬性

類型:	SPAssignmentCollection
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Identity

適用：SharePoint Server 2016，SharePoint Server 2019

指定伺服器陣列中伺服器的名稱。

參數屬性

類型:	SPServerPipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	地址

參數集

(All)

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Role

適用：SharePoint Server 2016，SharePoint Server 2019

指定您要變更的伺服器角色名稱。

有效的值為：

• WebFrontEnd
• 應用程式
• SingleServerFarm
• 分散式快取
• 搜尋
• 自訂
• ApplicationWithSearch
• WebFrontEndWithDistributedCache

參數屬性

類型:	SPServerRole
預設值:	None
接受的值:	Application, ApplicationWithSearch, Custom, DistributedCache, Search, SingleServerFarm, WebFrontEnd, WebFrontEndWithDistributedCache
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Status

適用：SharePoint Server 2016，SharePoint Server 2019

設定伺服器陣列中伺服器的狀態。

參數屬性

類型:	SPObjectStatus
預設值:	None
接受的值:	Online, Disabled, Offline, Unprovisioning, Provisioning, Upgrading, Patching
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Microsoft.SharePoint.PowerShell.SPServerPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

輸出

System.Object