New-SPConfigurationDatabase

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Erstellt eine neue Konfigurationsdatenbank.

Syntax

New-SPConfigurationDatabase
   [-DatabaseName] <String>
   [-DatabaseServer] <String>
   [[-DirectoryDomain] <String>]
   [[-DirectoryOrganizationUnit] <String>]
   [[-AdministrationContentDatabaseName] <String>]
   [[-DatabaseCredentials] <PSCredential>]
   [-FarmCredentials] <PSCredential>
   [-Passphrase] <SecureString>
   [-SkipRegisterAsDistributedCacheHost]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-DatabaseFailOverServer <String>]
   [-LocalServerRole <SPServerRole>]
   [-ServerRoleOptional]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet New-SPConfigurationDatabase wird auf dem angegebenen Datenbankserver eine neue Konfigurationsdatenbank erstellt. Hierbei handelt es sich um die zentrale Datenbank für eine neue SharePoint-Farm.

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-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential)

In diesem Beispiel wird der Benutzer aufgefordert, Benutzeranmeldeinformationen für das Standardkonto des Farmadministrators anzugeben.

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

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -SkipRegisterAsDistributedCacheHost

In diesem Beispiel wird der Benutzer aufgefordert, Benutzeranmeldeinformationen für das Standardkonto des Farmadministrators anzugeben, und überspringt die Registrierung des Servers als Verteilter Cachehost. Gilt nur für SharePoint Server 2013 und SharePoint Server 2016, SharePoint Server 2019.

------------------BEISPIEL 3-----------------------

New-SPConfigurationDatabase -DatabaseName "SharePointConfigDB1" -DatabaseServer "SQL-01" -Passphrase (ConvertTo-SecureString "MyPassword" -AsPlainText -force) -FarmCredentials (Get-Credential) -LocalServerRole Custom

In diesem Beispiel wird der Benutzer aufgefordert, Benutzeranmeldeinformationen für das Standardkonto des Farmadministrators anzugeben, und legt die Serverrolle auf Benutzerdefiniert fest. Gilt nur für SharePoint Server 2016, SharePoint Server 2019.

Parameter

-AdministrationContentDatabaseName

Gibt den Namen für die Inhaltsdatenbank der Zentraladministration für die neue Farm an. Wenn kein Name angegeben wird, wird ein Standardname verwendet.

Type:	String
Position:	5
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

-DatabaseCredentials

Gibt das Credential-Objekt für den Datenbankbenutzer an. Verwenden Sie diesen Parameter, wenn Sie die SQL Server-Authentifizierung verwenden. Wenn keine Anmeldeinformationen angegeben werden, wird die Windows-Authentifizierung verwendet.

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

-DatabaseFailOverServer

Gibt den SQL Server Datenbankspiegel-Partnerserver für die Konfigurations- und Zentraladministrationsdatenbank an.

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

-DatabaseName

Gibt den Namen der neuen Konfigurationsdatenbank an.

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

-DatabaseServer

Gibt den Datenbankserver an, auf dem die Konfigurationsdatenbank erstellt werden soll. Wenn kein Wert angegeben wird, wird der Standardwert verwendet.

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

-DirectoryDomain

Gibt die Verzeichnisdomäne für die neue Farm an. Wenn keine Domäne angegeben wird, wird die Domäne verwendet, in der sich der lokale Computer befindet.

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

-DirectoryOrganizationUnit

Gibt die Active Directory-Organisationseinheit für die neue Konfigurationsdatenbank an. Wenn keine Organisationseinheit angegeben wird, wird die Organisationseinheit verwendet, in der sich der lokale Computer befindet.

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

-FarmCredentials

Gibt Anmeldeinformationen für das Konto des Farmadministrators an.

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

-LocalServerRole

Gibt die Serverrolle an. Gültige Optionen für alle Versionen von SharePoint Server 2016, SharePoint Server 2019: Custom, SingleServerFarm, Application, WebFrontEnd, , DistributedCache,Search

Mit dem Feature Pack 1 sind folgende neue Optionen verfügbar: ApplicationWithSearch, WebFrontEndWithDistributedCache

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

-Passphrase

Gibt die sichere Kennwortphrase für die neue Farm an. Diese Passphrase wird zum Hinzufügen weiterer Computer zu dieser Farm verwendet.

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

-ServerRoleOptional

Konfiguriert die Farm so, dass keine Serverrolle angegeben werden muss. Wenn keine Serverrolle angegeben wird, wird standardmäßig die benutzerdefinierte Rolle für den Server festgelegt.

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

-SiteMapDatabaseName

Nicht verwenden. Gibt den Datenbanknamen der Sitemap-Website an.

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

-SiteMapDatabaseServer

Nicht verwenden. Gibt den Datenbankservernamen der Sitemap-Website an.

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

-SkipRegisterAsDistributedCacheHost

Standardmäßig werden alle Server in der Farm als Cachehost registriert (das heißt, DistributedCacheService wird standardmäßig ausgeführt).

Verwenden Sie diesen Parameter, um den Servercomputer nicht als verteilten Cachehost zu registrieren. Wenn Sie einen speziellen Cachehost verwenden möchten, verwenden Sie diesen Parameter, um sicherzustellen, dass der Cachedienst nicht auf dem Computer installiert wird.

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