sp_syscollector_delete_collection_item (Transact-SQL)
Gilt für: 
SQL Server
Löscht ein Sammelelement aus einem Sammlungssatz.
Transact-SQL-Syntaxkonventionen
Syntax
sp_syscollector_delete_collection_item
[ [ @collection_item_id = ] collection_item_id ]
[ , [ @name = ] N'name' ]
[ ; ]
Argumente
[ @collection_item_id = ] collection_item_id
Der eindeutige Bezeichner für das Sammlungselement. @collection_item_id ist int mit einem Standardwert von NULL. @collection_item_id muss einen Wert aufweisen, wenn @name istNULL.
[ @name = ] N'name'
Der Name des Auflistungselements. @name ist "sysname" mit einem Standardwert einer leeren Zeichenfolge. @name muss einen Wert aufweisen, wenn @collection_item_id istNULL.
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Hinweise
sp_syscollector_delete_collection_item muss im Kontext der msdb Systemdatenbank ausgeführt werden. Sammlungselemente können nicht aus Systemsammlungssätzen gelöscht werden.
Der Sammlungssatz mit dem Sammelelement wird während dieses Vorgangs beendet und neu gestartet.
Berechtigungen
Erfordert die Mitgliedschaft in der festen Datenbankrolle dc_admin (mit EXECUTE-Berechtigung), um dieses Verfahren auszuführen.
Beispiele
Im folgenden Beispiel wird ein Sammelelement mit dem Namen MyCollectionItem1 gelöscht.
USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';