New-SPCentralAdministration

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Erstellt eine neue Webanwendung für die SharePoint-Zentraladministration.

Syntax

New-SPCentralAdministration
   [-Port] <Int32>
   [[-WindowsAuthProvider] <String>]
   [-SecureSocketsLayer]
   [[-HostHeader] <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Url <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

New-SPCentralAdministration
   [[-WindowsAuthProvider] <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-SPCentralAdministration wird eine neue Webanwendung für die Zentraladministration erstellt und der Zentraladministrationsdienst auf dem lokalen Computer gestartet. Die Zentraladministration ist nur auf Computern verfügbar, auf denen der Dienst ausgeführt wird.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

------------------BEISPIEL 1-----------------------

New-SPCentralAdministration -WindowsAuthProvider NTLM -Port 8080

In diesem Beispiel wird der Standort der Zentraladministration an Port 8080 in der lokalen Farm mithilfe der NTLM-Authentifizierung erstellt.

------------------BEISPIEL 2-----------------------

New-SPCentralAdministration -WindowsAuthProvider Kerberos -Port 443 -SecureSocketsLayer -HostHeader centraladmin.example.com

In diesem Beispiel wird der Standort der Zentraladministration unter Verwendung von SSL an Port 443 mit dem Hostheader centraladmin.example.com und kerberos-Authentifizierung erstellt.

Parameter

-AllowLegacyEncryption

Gibt an, dass ältere SSL- und TLS-Protokollversionen und Verschlüsselungssammlungen mit dieser IIS-Website verwendet werden dürfen. Legacyverschlüsselung ist schwächer als die moderne Verschlüsselung und wird nicht empfohlen.

Dieses Feature erfordert Windows Server 2022 oder höher. Dieses Feature ist nicht verfügbar, wenn SharePoint mit früheren Versionen von Windows Server bereitgestellt wird.

Dieser Parameter ist nur gültig, wenn er mit dem Parameter SecureSocketsLayer verwendet wird.

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

-AssignmentCollection

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.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

-Certificate

Gibt das Zertifikat an, das für die SSL-Bindung (Secure Sockets Layer) dieser IIS-Website verwendet wird. Dieser Parameter ist nur gültig, wenn er mit dem Parameter SecureSocketsLayer verwendet wird.

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

-HostHeader

Gibt den Hostheader der IIS-Website der Zentraladministration an.

Wenn dieser Parameter nicht angegeben wird, gibt es keine Hostheaderbindung, und die URL der Website der Zentraladministration basiert auf dem Namen dieses Servers.

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

-Port

Gibt die Portnummer für die Zentraladministration an. Wenn kein Port angegeben wird, wird automatisch eine nicht widersprüchliche Portnummer generiert.

Der Typ muss eine gültige Portnummer sein.

Wenn Sie eine Portnummer angeben, die bereits zugewiesen wurde, startet IIS die neue Website erst, wenn Sie die Portnummer der neuen Website oder die Portnummer der alten Website ändern.

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

-SecureSocketsLayer

Aktiviert SSL-Verschlüsselung (Secure Sockets Layer) für die IIS-Website der Zentraladministration. Wenn Sie SSL verwenden möchten, müssen Sie ein Serverzertifikat in SharePoint importieren und es der IIS-Website der Zentraladministration zuweisen. Der Zugriff auf die Webanwendung für die Zentraladministration ist erst danach möglich.

Der Standardwert ist False.

Wenn dieser Parameter ausgelassen oder auf False festgelegt ist, verwendet der Standort der Zentraladministration HTTP für den angegebenen Port.

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

-Url

Gibt die URL mit Lastenausgleich für die Zentraladministration an.

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

-UseServerNameIndication

Gibt an, dass für die SSL-Bindung (Secure Sockets Layer) dieser IIS-Website SNI (Server Name Indication) verwendet werden soll. Die Servernamensanzeige ermöglicht es mehreren IIS-Websites mit eindeutigen Hostheadern und eindeutigen Serverzertifikaten, denselben SSL-Port gemeinsam zu nutzen. Wenn die Servernamensanzeige nicht verwendet wird, müssen alle IIS-Websites, die denselben SSL-Port verwenden, dasselbe Serverzertifikat verwenden.

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

-WindowsAuthProvider

Gibt den Authentifizierungsanbieter für diese Webanwendung an. Wenn kein Autorisierungsanbieter angegeben wird, wird der Standardwert NTLM verwendet.

Der Typ muss einer von zwei Werten sein: Kerberos oder NTLM.

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