Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Classe JobSchedule

SQL Server 2008 R2

The JobSchedule class represents a SQL Server Agent job schedule.

System..::..Object
  Microsoft.SqlServer.Management.Smo..::..SmoObjectBase
    Microsoft.SqlServer.Management.Smo..::..SqlSmoObject
      Microsoft.SqlServer.Management.Smo..::..NamedSmoObject
        Microsoft.SqlServer.Management.Smo.Agent..::..AgentObjectBase
          Microsoft.SqlServer.Management.Smo.Agent..::..ScheduleBase
            Microsoft.SqlServer.Management.Smo.Agent..::..JobSchedule

Espace de noms : Microsoft.SqlServer.Management.Smo.Agent
Assembly : Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

C++

JScript

[SfcElementTypeAttribute("Schedule")]
public sealed class JobSchedule : ScheduleBase, 
	IAlterable, ICreatable, IDroppable, IRenamable, IScriptable

Le type JobSchedule expose les membres suivants.

Constructeurs

	Nom	Description
	JobSchedule()()()()	Initializes a new instance of the JobSchedule class.
	JobSchedule(SqlSmoObject, String)	Initializes a new instance of the JobSchedule class for the specified parent object and that has the specified name.

Haut de la page

Propriétés

	Nom	Description
	ActiveEndDate	Gets or sets the date and time when the schedule ends.
	ActiveEndTimeOfDay	Gets or sets the time when the job schedule stops for the day.
	ActiveStartDate	Gets or sets the date and time when the schedule starts.
	ActiveStartTimeOfDay	Gets or sets the time when the job schedule starts for the day.
	DateCreated	Gets the date and time when the job schedule was created.
	ExecuteForScalar	Obtient ou définit la valeur de la propriété Boolean qui spécifie si l'objet est défini selon l'option permettant l'exécution qui retourne une valeur scalaire. (hérité de SqlSmoObject.)
	FrequencyInterval	Gets or sets the frequency interval, which determines how often the job is scheduled to run.
	FrequencyRecurrenceFactor	Gets or sets the number of weeks or months between scheduled jobs for schedules with a weekly or monthly frequency type, respectively.
	FrequencyRelativeIntervals	Gets or sets the ordinal value of a day relative to the first day of the month, such as first, second, or last.
	FrequencySubDayInterval	Gets or sets the interval between scheduled jobs that run during the day.
	FrequencySubDayTypes	Gets or sets the unit of time used to specify the interval between scheduled jobs that run during the day.
	FrequencyTypes	Gets or sets the way in which frequency is evaluated for the job schedule, whether it's one time only, or weekly, or when the processor is idle, for example.
	ID	Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. Gets the ID value that uniquely identifies the schedule. (hérité de ScheduleBase.)
	IsEnabled	Gets or sets the Boolean property value that specifies whether the job schedule is enabled or disabled.
	IsTouched	Obtient la valeur de la propriété Boolean qui spécifie si les propriétés de l'objet ont été mises à jour mais n'ont pas encore été rendues persistantes sur le serveur. (hérité de SqlSmoObject.)
	JobCount	Gets the number of jobs that require the referenced job schedule.
	Name	Gets or sets the name of the object. (hérité de NamedSmoObject.)
	ObjectInSpace	Obtient la valeur de la propriété Boolean qui spécifie si l'objet existe dans l'isolation, ou s'il est connecté directement ou indirectement à l'instance de SQL Server. (hérité de SqlSmoObject.)
	Parent	Gets or sets the Job object that is the parent of the JobSchedule object.
	Properties	Obtient une collection d'objets Property qui représentent les propriétés de l'objet. (hérité de SqlSmoObject.)
	ScalarResult	Obtient le résultat scalaire pour l'objet référencé. (hérité de SqlSmoObject.)
	ScheduleUid	Gets and sets the Guid for the schedule associated with the instance.
	State	Gets the state of the referenced object. (hérité de SmoObjectBase.)
	Urn	Obtient la valeur URN (Uniform Resource Name) qui identifie de façon unique l'objet. (hérité de SqlSmoObject.)
	UserData	Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.)

Haut de la page

Méthodes

	Nom	Description
	AddDatabaseContext(StringCollection)	Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries. (hérité de SqlSmoObject.)
	AddDatabaseContext(StringCollection, ScriptingOptions)	Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries, à l'aide des options de script spécifiées. (hérité de SqlSmoObject.)
	Alter	Updates any JobSchedule object property changes on an instance of Microsoft SQL Server.
	AlterImpl	Active l'événement d'objet modifié. (hérité de SqlSmoObject.)
	AlterImplFinish	Méthode appelée lorsque l'événement d'objet modifié est terminé. (hérité de SqlSmoObject.)
	AlterImplInit	Méthode appelée lorsque l'événement d'objet modifié est initialisé. (hérité de SqlSmoObject.)
	AlterImplWorker	Appelle les méthodes de modification. (hérité de SqlSmoObject.)
	BindDefaultImpl	Lie les éléments par défaut identifiés par les paramètres. (hérité de SqlSmoObject.)
	BindRuleImpl	Lie le schéma de règle à la règle et aux colonnes identifiées par les paramètres. (hérité de SqlSmoObject.)
	CheckCollation	Vérifie l'ordre des options de script par la méthode de classement identifiée par le paramètre collationName. (hérité de SqlSmoObject.)
	CheckObjectState()()()()	Valide l'état de l'objet référencé. (hérité de SqlSmoObject.)
	CheckObjectState(Boolean)	Valide l'état de l'objet référencé avec l'option permettant de spécifier qu'une exception est levée si l'objet n'est pas encore créé. (hérité de SqlSmoObject.)
	CheckObjectStateImpl	Vérifie l'état de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	CheckVersion100	Vérifie si la version de SQL Server est SQL Server 2008. (hérité de SqlSmoObject.)
	CheckVersion80	Vérifie la validité de l'objet sur SQL Server 2000. (hérité de SqlSmoObject.)
	CheckVersion80SP3	Vérifie la validité de l'objet sur SQL Server 2000 SP3. (hérité de SqlSmoObject.)
	CheckVersion90	Vérifie la validité de l'objet sur SQL Server 2005. (hérité de SqlSmoObject.)
	CheckVersionBelow90	Vérifie si la version de SQL Server est antérieure à SQL Server 2005. (hérité de SqlSmoObject.)
	CleanObject	Définit l'objet sur l'état non modifié. (hérité de SqlSmoObject.)
	Create	Creates a job schedule on the instance of SQL Server as defined by the JobSchedule object.
	CreateImpl	Crée un objet avec les options de script. (hérité de SqlSmoObject.)
	CreateImplFinish	Méthode appelée lorsque l'événement de création est terminé. (hérité de SqlSmoObject.)
	CreateImplInit	Méthode appelée lorsque l'événement de création est initialisé. (hérité de SqlSmoObject.)
	Discover	Découvre une liste de type Object. (hérité de SqlSmoObject.)
	Drop()()()()	Removes the referenced job schedule.
	Drop(Boolean)	Removes the referenced job schedule.
	DropImpl	Supprime un SqlSmoObject. (hérité de SqlSmoObject.)
	DropImplWorker	Appelle les méthodes de suppression. (hérité de SqlSmoObject.)
	EnumJobReferences	Returns an enumerated list of jobs that reference the schedule.
	EnumScriptImpl	Énumère des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
	EnumScriptImplWorker	Appelle les méthodes qui énumèrent des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
	EnumScriptImplWorkerSOChanged	Retourne une chaîne IEnumerable qui décrit les options de script pour un objet. (hérité de SqlSmoObject.)
	Equals	(hérité de Object.)
	ExecuteNonQuery	(hérité de SqlSmoObject.)
	Finalize	(hérité de Object.)
	FormatSqlVariant	Met en forme un objet en tant que type SqlVariant. (hérité de SqlSmoObject.)
	GenerateDataSpaceFileStreamScript	Génère un script pour créer un fichier de données. (hérité de SqlSmoObject.)
	GenerateDataSpaceScript	Génère un script pour allouer l'espace dans le fichier de données. (hérité de SqlSmoObject.)
	GetBindDefaultScript	Obtient le script qui lie les valeurs par défaut spécifiées par les paramètres defName et defSchema. (hérité de SqlSmoObject.)
	GetBindRuleScript	Obtient le script qui spécifie les règles de liaison. (hérité de SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre booléen du SqlSmoObject. (hérité de SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte une propriété booléenne du SqlSmoObject. (hérité de SqlSmoObject.)
	GetDateTimeParameter	Affecte une propriété datetime du SqlSmoObject. (hérité de SqlSmoObject.)
	GetDateTimeParameterAsInt	Affecte la propriété datetime du SqlSmoObject comme une valeur entière, si la propriété datetime n'est pas Null. (hérité de SqlSmoObject.)
	GetDBName	Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. Gets the database name that is associated with the object. (hérité de AgentObjectBase.)
	GetEnumParameter	Affecte une propriété d'énumération du SqlSmoObject. (hérité de SqlSmoObject.)
	GetFragOptionString	Obtient un objet FragmentationOption en tant que valeur de chaîne. (hérité de SqlSmoObject.)
	GetGuidParameter	Affecte une propriété Guid du SqlSmoObject. (hérité de SqlSmoObject.)
	GetHashCode	(hérité de Object.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValue	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValueOptional	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValueOptionalAllowNull	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetRealValue	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetScriptingOptionsForCreate	Obtient ScriptingOptions pour l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetServerName	Obtient le nom de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
	GetServerObject	Obtient le serveur de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetSqlServerVersionName	Obtient le nom de version de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetTimeSpanParameterAsInt	Affecte un paramètre d'intervalle de temps de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetType	(hérité de Object.)
	GetUrnRecursive(StringBuilder)	Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetUrnRecursive(StringBuilder, UrnIdOption)	Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	ImplInitialize	Initialise les champs de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	Initialize()()()()	Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
	Initialize(Boolean)	Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
	IsObjectDirty	Vérifie si les propriétés de l'objet ont été modifiées et si les modifications n'ont pas encore été rendues persistantes sur l'instance de SQL Server. (hérité de SqlSmoObject.)
	IsObjectInitialized	Vérifie si l'objet a été initialisé. (hérité de SqlSmoObject.)
	IsObjectInSpace	Vérifie si l'objet est isolé ou connecté à l'instance de SQL Server. (hérité de SqlSmoObject.)
	IsVersion80SP3	Détermine si la version de SQL Server est SQL Server 2000 avec SP3. (hérité de SqlSmoObject.)
	IsVersion90AndAbove	Détermine si la version de SQL Server est SQL Server 2005 ou une version ultérieure. (hérité de SqlSmoObject.)
	MarkDropped	Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
	MarkForDropImpl	Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
	MemberwiseClone	(hérité de Object.)
	PostAlter	Méthode activée après la modification du SqlSmoObject. (hérité de SqlSmoObject.)
	PostCreate	Méthode activée après la création du SqlSmoObject. (hérité de SqlSmoObject.)
	PostDrop	Méthode activée après la suppression du SqlSmoObject. (hérité de SqlSmoObject.)
	Refresh	Actualise l'objet et récupère les propriétés lors du prochain accès à l'objet. (hérité de SqlSmoObject.)
	Rename	Renames the job schedule.
	RenameImpl	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.)
	RenameImplWorker	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.)
	Script()()()()	Generates a Transact-SQL script that can be used to re-create the SQL Server Agent job schedule.
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the SQL Server Agent job schedule as specified by the scripting options.
	ScriptAlter	Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
	ScriptChangeOwner	This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.)
	ScriptCreate	Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
	ScriptDdl	Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
	ScriptDrop	Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
	ScriptImpl()()()()	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptImpl(ScriptingOptions)	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptImplWorker	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptOwner	Alters the script owner authorization. (hérité de NamedSmoObject.)
	ScriptRename	This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.)
	SetId	Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. Sets the ID value that uniquely identifies the schedule. (hérité de ScheduleBase.)
	SetParentImpl	Définit le parent du SqlSmoObject sur le paramètre newParent. (hérité de SqlSmoObject.)
	SetSchemaOwned	Sets the schema owned value. (hérité de NamedSmoObject.)
	ToString	Retourne un String qui représente l'objet référencé. (hérité de SqlSmoObject.)
	TouchImpl	Non implémenté. (hérité de SqlSmoObject.)
	UnbindDefaultImpl	Annule la liaison des colonnes par défaut du SqlSmoObject. (hérité de SqlSmoObject.)
	UnbindRuleImpl	Annule la liaison des règles du SqlSmoObject. (hérité de SqlSmoObject.)
	Validate	Validates the state of an object. (hérité de SmoObjectBase.)

Haut de la page

Événements

	Nom	Description
	PropertyChanged	Représente l'événement qui se produit lorsqu'une propriété est modifiée. (hérité de SqlSmoObject.)
	PropertyMetadataChanged	Représente l'événement qui se produit lorsque les métadonnées de la propriété sont modifiées. (hérité de SqlSmoObject.)

Haut de la page

Champs

	Nom	Description
	m_ExtendedProperties	Représente une propriété définie pour étendre les propriétés fournies par un SqlSmoObject. (hérité de SqlSmoObject.)
	singletonParent	Représente le parent de singleton. (hérité de SqlSmoObject.)

Haut de la page

Implémentations d'interfaces explicites

	Nom	Description
	IAlienObject..::..Discover	Découvre les éventuelles dépendances. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject..::..GetDomainRoot	Retourne la racine du domaine. (hérité de SqlSmoObject.)
	IAlienObject..::..GetParent	Obtient le parent de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject..::..GetPropertyType	Obtient le type de la propriété spécifiée. (hérité de SqlSmoObject.)
	IAlienObject..::..GetPropertyValue	Obtient la valeur de la propriété spécifiée. (hérité de SqlSmoObject.)
	IAlienObject..::..GetUrn	Obtient l'URN (Uniform Resource Name) de l'objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject..::..Resolve	Obtient l'instance qui contient les informations relatives à l'objet de l'URN (Unified Resource Name) de l'objet. (hérité de SqlSmoObject.)
	IAlienObject..::..SetObjectState	Définit l'état de l'objet sur la valeur SfcObjectState spécifiée. (hérité de SqlSmoObject.)
	IAlienObject..::..SetPropertyValue	Définit la valeur de la propriété. (hérité de SqlSmoObject.)
	ISfcPropertyProvider..::..GetPropertySet	Obtient la référence d'interface au jeu de propriétés de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)

Haut de la page

Notes

SQL Server Agent jobs can be scheduled to run by using SQL Server Agent. Jobs can be scheduled to run when SQL Server Agent is enabled, but jobs are not required to be scheduled. They can be run on demand by a sufficiently privileged user. Jobs can have more than one active schedule. SQL Server Agent evaluates all schedules to determine when to run the job. By using the JobSchedule object, you can do the following:

Create a schedule for a SQL Server Agent job.
Remove a schedule from an existing SQL Server Agent job.
Manage job schedules either by enabling a schedule or adjusting run times or frequencies.

To get or set JobSchedule object properties, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be the owner of the job, or be a member of the sysadmin fixed server role.

To create a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.

To drop a job schedule, users must be a member of the SQLAgentUserRole database role on the MSDB database, or be a member of the sysadmin fixed server role.

Thread Safety

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type est sûr dans le cadre des opérations à plusieurs threads. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Exemples

Planification des tâches administratives automatiques dans l'Agent SQL Server

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms Microsoft.SqlServer.Management.Smo.Agent

Autres ressources

Automatisation des tâches administratives (Agent SQL Server)

sp_add_schedule (Transact-SQL)

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Ajouts de la communauté

AJOUTER

Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,

Confidentialité