Set-SPServer

Modul:

SharePointServer module

Ändert die Rolle des Servers.

Syntax

Default (Standardwert)

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

Beschreibung

Das Set-SPServer-Cmdlet ändert die Rolle des Servers in der Farm mithilfe des Role-Parameters. Ein neues Cmdlet in SharePoint Server 2016, SharePoint Server 2019, das in MinRole verwendet wird.

Beispiele

BEISPIEL

Set-SPServer -Role SingleServerFarm

In diesem Beispiel wird der Server zur SingleServerFarm-Rolle geändert.

Parameter

-AssignmentCollection

Anwendbar: SharePoint Server 2016, SharePoint Server 2019

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.

HINWEIS: Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Parametereigenschaften

Typ:	SPAssignmentCollection
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Anwendbar: SharePoint Server 2016, SharePoint Server 2019

Gibt den Namen des Servers in der Farm an.

Parametereigenschaften

Typ:	SPServerPipeBind
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Adresse

Parametersätze

(All)

Position:	0
Obligatorisch.:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Role

Anwendbar: SharePoint Server 2016, SharePoint Server 2019

Gibt den Namen der Serverrolle an, die Sie ändern möchten.

Folgende Werte sind gültig:

• WebFrontEnd
• Application
• SingleServerFarm
• Verteilter Cache
• Suche
• Benutzerdefiniert
• ApplicationWithSearch
• WebFrontEndWithDistributedCache

Parametereigenschaften

Typ:	SPServerRole
Standardwert:	None
Zulässige Werte:	Application, ApplicationWithSearch, Custom, DistributedCache, Search, SingleServerFarm, WebFrontEnd, WebFrontEndWithDistributedCache
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Status

Anwendbar: SharePoint Server 2016, SharePoint Server 2019

Legt den Status des Servers in der Farm fest.

Parametereigenschaften

Typ:	SPObjectStatus
Standardwert:	None
Zulässige Werte:	Online, Disabled, Offline, Unprovisioning, Provisioning, Upgrading, Patching
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Eingaben

Microsoft.SharePoint.PowerShell.SPServerPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Ausgaben

System.Object