New-SPConfigurationDatabase
Erstellt eine neue Konfigurationsdatenbank.
Syntax
Default (Standardwert)
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
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Namen für die Inhaltsdatenbank der Zentraladministration für die neue Farm an. Wenn kein Name angegeben wird, wird ein Standardname verwendet.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 5 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-AssignmentCollection
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, 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.
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.
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 |
-DatabaseCredentials
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 6 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-DatabaseFailOverServer
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den SQL Server Datenbankspiegel-Partnerserver für die Konfigurations- und Zentraladministrationsdatenbank an.
Parametereigenschaften
| Typ: | String |
| 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: | True |
| Wert aus verbleibenden Argumenten: | False |
-DatabaseName
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Namen der neuen Konfigurationsdatenbank an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-DatabaseServer
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt den Datenbankserver an, auf dem die Konfigurationsdatenbank erstellt werden soll. Wenn kein Wert angegeben wird, wird der Standardwert verwendet.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-DirectoryDomain
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 3 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-DirectoryOrganizationUnit
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 4 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-FarmCredentials
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt Anmeldeinformationen für das Konto des Farmadministrators an.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 7 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-LocalServerRole
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
Gibt die Serverrolle an. Gültige Optionen für alle Versionen von SharePoint Server 2016, SharePoint Server 2019: Custom, , , ApplicationWebFrontEnd, , DistributedCacheSingleServerFarm,Search
Mit dem Feature Pack 1 sind folgende neue Optionen verfügbar: ApplicationWithSearch, WebFrontEndWithDistributedCache
Parametereigenschaften
| Typ: | SPServerRole |
| Standardwert: | None |
| 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 |
-Passphrase
Anwendbar: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Gibt die sichere Kennwortphrase für die neue Farm an. Diese Passphrase wird zum Hinzufügen weiterer Computer zu dieser Farm verwendet.
Parametereigenschaften
| Typ: | SecureString |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 8 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ServerRoleOptional
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| 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 |
-SiteMapDatabaseName
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
Nicht verwenden. Gibt den Datenbanknamen der Sitemap-Website an.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| 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 |
-SiteMapDatabaseServer
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
Nicht verwenden. Gibt den Datenbankservernamen der Sitemap-Website an.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| 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 |
-SkipRegisterAsDistributedCacheHost
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 9 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| 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.