New-SPWebApplication
Erstellt in der lokalen Farm eine neue Webanwendung.
Syntax
New-SPWebApplication
-Name <String>
-ApplicationPool <String>
[-ApplicationPoolAccount <SPProcessAccountPipeBind>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Port <UInt32>]
[-AllowAnonymousAccess]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseServer <String>]
[-DatabaseName <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Erstellt eine neue Webanwendung, die durch den Parameter Name angegeben wird. Der durch den DatabaseCredentials-Parameter angegebene Benutzer muss Mitglied der festen Serverrolle dbcreator auf dem Datenbankserver sein.
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-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")In diesem Beispiel wird eine neue Webanwendung mithilfe eines internen Hostheaders von sharepoint.contoso.com und einer öffentlichen URL von http://www.contoso.comerstellt.
------------------BEISPIEL 2-----------------------
New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")In diesem Beispiel wird eine neue SSL-fähige Webanwendung mithilfe eines internen Hostheaders von sharepoint.contoso.com und einer öffentlichen URL von https://www.contoso.comerstellt.
------------------BEISPIEL 3-----------------------
$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com" -Port 443
-ApplicationPool "ContosoAppPool"
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")
-AuthenticationProvider $ap -SecureSocketsLayerErstellt eine Windows Claims-Webanwendung unter der URL https://www.contoso.com mithilfe des Domänenkontos domain\wa.
Parameter
-AdditionalClaimProvider
Fügt der definierten Webanwendung einen bestimmten Anspruchsanbieter hinzu.
| Type: | SPClaimProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AllowAnonymousAccess
Ermöglicht anonymen Zugriff auf die Webanwendung.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ApplicationPool
Gibt den Namen eines zu verwendenden Anwendungspools an. Beispiel: SharePoint – 1213. If an application pool with the name provided does not exist, the ApplicationPoolAccount parameter must be provided and a new application pool will be created. If no value is specified, the default application pool will be used.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ApplicationPoolAccount
Gibt das Benutzerkonto an, als das dieser Anwendungspool ausgeführt wird.
Verwenden Sie das Get-SPIisWebServicApplicationPool Cmdlet, um ein Systemkonto zu verwenden.
| Type: | SPProcessAccountPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-AuthenticationMethod
Verwendet Kerberos oder NTLM zum Angeben der Authentifizierungsmethode. Wenn kein Wert angegeben wird, wird der Standardwert NTLM verwendet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Gibt mindestens einen Authentifizierungsanbieter an, der für eine Webanwendung gilt.
| Type: | SPAuthenticationProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-Confirm
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 Subscription Edition |
-DatabaseCredentials
Gibt das Credential -Objekt der Windows PowerShell für das Datenbankbenutzerkonto an.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DatabaseName
Gibt den Namen der anfänglichen Inhaltsdatenbank für die neue Webanwendung an.
The type must be a valid database name; for example, ContentDB1. Wenn kein Wert angegeben wird, wird automatisch ein Wert im Format WSS_Content_<GUID> generiert.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DatabaseServer
Specifies the database server name. The type must be a valid database server name, in the form SQL1; where named instances are used, the format can appear as server\server. The default SQL server instance is used if a value is not provided.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HostHeader
Gibt die Hostheaderbindung für diese IIS-Website an. Eine Hostheaderbindung ermöglicht es mehreren IIS-Websites, dieselbe Portnummer gemeinsam zu verwenden. Webanforderungen, die an eine freigegebene Portnummer gesendet werden, werden basierend auf dem Wert des vom Client gesendeten HTTP-Hostheaders an die richtige IIS-Website weitergeleitet.
Wenn keine Hostheaderbindung angegeben ist, werden alle Webanforderungen, die an diese Portnummer gesendet werden, an diese IIS-Website weitergeleitet, es sei denn, eine andere IIS-Website verfügt über eine Hostheaderbindung, die mit dem vom Client gesendeten HTTP-Hostheader übereinstimmt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Gibt den Namen der neuen Webanwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
Gibt das physische Verzeichnis für die neue Webanwendung im Ordner "Virtuelle Verzeichnisse" an. Bei dem Typ handelt es sich um einen gültigen Pfad im Format C:\Inetpub\wwwroot\MeineWebAnwendung. Wenn kein Wert angegeben wird, wird der Wert %wwwroot%\wss\VirtualDirectories\<portnumber> angewendet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Port
Gibt den Port an, über den auf diese Webanwendung zugegriffen werden kann. Dabei kann es sich um eine beliebige gültige Portnummer handeln. Wird kein Port angegeben, wird automatisch eine Portnummer generiert, die keine Konflikte verursacht.
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: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SecureSocketsLayer
Aktiviert SSL-Verschlüsselung (Secure Sockets Layer) für diese Webanwendung. Wenn Sie ssl verwenden möchten, müssen Sie ein Serverzertifikat in SharePoint importieren und es der IIS-Website für diese Webanwendung zuweisen. Solange dies nicht geschehen ist, kann von dieser IIS-Website nicht auf die Webanwendung zugegriffen werden.
Der Standardwert ist False.
Wenn dieser Parameter ausgelassen oder auf False festgelegt wird, verwendet diese Webanwendung HTTP für den angegebenen Port.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServiceApplicationProxyGroup
Gibt eine benutzerdefinierte Dienstanwendungs-Proxygruppe an, die die Webanwendung verwenden soll. Die Webanwendung verwendet die Proxys in dieser Gruppe, um eine Verbindung mit Dienstanwendungen herzustellen. Wenn dieser Parameter nicht angegeben wird, wird die Standardproxygruppe für die Farm verwendet.
| Type: | SPServiceApplicationProxyGroupPipeBind |
| Aliases: | ProxyGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectProvider
Legt die Umleitungs-URL für die Anmeldung so fest, dass sie auf die URL verweist, die im angegebenen Authentifizierungsanbieter definiert ist.
| Type: | SPTrustedIdentityTokenIssuerPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectURL
Legt die Umleitungs-URL für die Webanwendung fest.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Url
Gibt die Lastenausgleichs-URL für die Webanwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UserSettingsProvider
Bietet Zugriff auf externen Benutzereinstellungsanbieter.
| Type: | SPUserSettingsProviderPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 Subscription Edition |