Test-SPContentDatabase
Testet eine Inhaltsdatenbank.
Syntax
Test-SPContentDatabase
[-Identity] <SPContentDatabasePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-ExtendedCheck]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-ShowLocation]
[-ShowRowCounts]
[<CommonParameters>] Test-SPContentDatabase
-Name <String>
-WebApplication <SPWebApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-ExtendedCheck]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-ShowLocation]
[-ShowRowCounts]
[<CommonParameters>] Beschreibung
Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.
Verwenden Sie das Test-SPContentDatabase Cmdlet, um eine Inhaltsdatenbank mit einer Webanwendung zu testen, um sicherzustellen, dass alle Anpassungen, auf die in der Inhaltsdatenbank verwiesen wird, auch in der Webanwendung installiert sind.
Dieses Cmdlet kann für eine Inhaltsdatenbank ausgegeben werden, die aktuell mit der Farm verbunden ist, oder für eine Inhaltsdatenbank, die nicht mit der Farm verbunden ist.
Es kann zum Testen von Inhaltsdatenbanken aus SharePoint 2010-Produkte und aus SharePoint-Produkte und -Technologien verwendet werden.
Das Test-SPContentDatabase Cmdlet ändert weder die Daten noch die Struktur der Inhaltsdatenbank, kann jedoch zu Einer Last der Datenbank führen, während die Überprüfungen ausgeführt werden, wodurch die Verwendung der Inhaltsdatenbank vorübergehend blockiert werden kann.
Das Cmdlet sollte nur für Inhaltsdatenbanken verwendet werden, die gegenwärtig nur von wenigen Benutzern oder gar nicht verwendet 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-----------------------
Test-SPContentDatabase -name WSS_Content_DB -webapplication https://sitenameIn diesem Beispiel wird die WSS_Content_DB Inhaltsdatenbank anhand der Sitename-Webanwendung getestet und eine Liste der Probleme zurückgegeben.
----------------------------BEISPIEL 2-----------------------
$DB = Get-SPContentDatabase -site https://contoso.com
Test-SPContentDatabase $DB -showrowcountsIn diesem Beispiel wird die Inhaltsdatenbank abgerufen, die die Websitesammlung enthält, https://contoso.com und dann die Datenbank anhand der Webanwendung getestet, die sie hostet, um Probleme zu ermitteln. Zusammen mit der Anzeige der Liste der Probleme durch Angabe des ShowRowCounts-Parameters gibt dies auch die Tabellengrößenmetriken aus der Inhaltsdatenbank zurück.
Parameter
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-DatabaseCredentials
Gibt das PSCredential -Objekt an, in dem der Benutzername und das Kennwort für die SQL Server-Authentifizierung bei der Datenbank enthalten sind.
Bei dem Typ muss es sich um ein gültiges PSCredential -Objekt handeln.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ExtendedCheck
Führt während des Upgrades durch Datenbankanfügungen eine Prüfung auf inkonsistente Authentifizierungsmodi durch.
Der ausgewählte Modus (forderungsbasiert oder klassisch) muss in beiden Versionen der gleiche sein.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
Gibt eine vorhandene verbundene SharePoint-Inhaltsdatenbank mit einem der beiden Parametersätze in Form einer GUID oder eines Datenbanknamens an, sofern diese eindeutig ist.
| Type: | SPContentDatabasePipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Name
Gibt die vorhandene Inhaltsdatenbank an, die getestet werden soll.
The type must be a valid name of a SharePoint content database; for example, SPContentDB1.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ServerInstance
Gibt die Instanz des Datenbankdienstes an, die zum Testen der angegebenen Inhaltsdatenbank verwendet werden soll.
The type must be a valid GUID, such as 12345678-90ab-cdef-1234-567890bcdefgh; a valid name of a SQL Server instance (for example, DBSvrInstance1); or an instance of a valid SPDatabaseServiceInstance object.
| Type: | SPDatabaseServiceInstancePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ShowLocation
Gibt die Speicherorte innerhalb der Datenbank an, an denen fehlende Vorlagen und Features verwendet werden. Typischerweise liegt der Bereich für gemeldete Speicherorte innerhalb der Websitesammlungen, die sich innerhalb der angegebenen Datenbank befinden.
Durch die Verwendung des Parameters erhöht sich der Zeitaufwand für die Durchführung des Testverfahrens deutlich.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ShowRowCounts
Gibt Datenbankstatistiken zurück, die als Zeilenanzahl in den Tabellen der Inhaltsdatenbank angezeigt werden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WebApplication
Gibt die SharePoint-Webanwendung an, die zum Testen der Inhaltsdatenbank verwendet werden soll.
The type must be a valid GUID, in the form 12345678-90ab-cdef-1234-567890bcdefgh; or a valid name of SharePoint Web application (for example, MyOfficeApp1); or an instance of a valid SPWebApplication object.
| Type: | SPWebApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |