Freigeben über


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://sitename

In 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 -showrowcounts

In 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