Freigeben über


SPFarm-Klasse

Stellt eine Microsoft SharePoint Foundation -Farm.

Vererbungshierarchie

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.Administration.SPPersistedObject
      Microsoft.SharePoint.Administration.SPPersistedUpgradableObject
        Microsoft.SharePoint.Administration.SPFarm

Namespace:  Microsoft.SharePoint.Administration
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
<GuidAttribute("674DA553-EA77-44a3-B9F8-3F70D786DE6A")> _
<UpgradableAttribute> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class SPFarm _
    Inherits SPPersistedUpgradableObject _
    Implements IBackupRestoreConfiguration, IBackupRestore, IMigratable
'Usage
Dim instance As SPFarm
[GuidAttribute("674DA553-EA77-44a3-B9F8-3F70D786DE6A")]
[UpgradableAttribute]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class SPFarm : SPPersistedUpgradableObject, IBackupRestoreConfiguration, 
    IBackupRestore, IMigratable

Hinweise

Das SPFarm -Objekt ist im obersten Knoten im Objektmodell extensible Konfiguration, die Interaktion mit dem Datenspeicher Konfiguration ausgelegt ist. Sie enthält die globale Einstellungen für alle Server, Dienste und Lösungen, die in einer Serverfarm installiert werden. Verwenden Sie die Servers, Servicesoder Solutions -Eigenschaft, um diese Auflistungen abzurufen.

Zugriff auf das aktuelle Objekt des Server-Farm können Sie Mitglieder auf SPFarm.Localverwenden. Um ein SPServiceCollection -Objekt zurückzugeben, die die Auflistung von Diensten in der aktuellen Farm darstellt, verwenden Sie beispielsweise SPFarm.Local.Services. Darüber hinaus können die Farm -Eigenschaft des von der SPPersistedObject -Klasse abgeleitete Klassen oder Sie können die Farm -Eigenschaft der SPSolution -Klasse zum Abrufen der Serverfarm des aktuellen Objekts oder der Lösung.

Beispiele

Im folgende Beispiel wird eine benutzerdefinierte Auftragsdefinition in jeder Webanwendung innerhalb der aktuellen Serverfarm registriert.

Dim farm As SPFarm = SPFarm.Local
Dim service As SPWebService = farm.Services.GetValue < SPWebService > ""

Dim webApp As SPWebApplication

For Each webApp In  service.WebApplications
    Dim job As SPJobDefinition

    For Each job In  webApp.JobDefinitions

        If job.Name = "MyCustomJobDefinitionName" Then
            j.Delete()
        End If
    Next job

    Dim newJob As New MyCustomJobDefinition("MyCustomJobDefinitionName", webApp)
    Dim schedule As SPSchedule = SPSchedule.FromString("every 5 minutes between 0 and 59")
    newJob.Schedule = schedule

    newJob.Update()
Next webApp
SPFarm farm = SPFarm.Local;
SPWebService service = farm.Services.GetValue<SPWebService>("");

foreach (SPWebApplication webApp in service.WebApplications)
{
    foreach (SPJobDefinition job in webApp.JobDefinitions)
    {
        if (job.Name == "MyCustomJobDefinitionName")
        {
            j.Delete();
        }
    }

    MyCustomJobDefinition newJob = new 
        MyCustomJobDefinition("MyCustomJobDefinitionName", webApp);
    SPSchedule schedule = SPSchedule.FromString("every 5 minutes between 0 and 59");
    newJob.Schedule = schedule;

    newJob.Update();
}

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

SPFarm-Member

Microsoft.SharePoint.Administration-Namespace