SMS_DistributionPoint classe WMI du serveur

La SMS_DistributionPoint classe WMI est une classe de serveur fournisseur SMS dans le gestionnaire de Configuration Manager. Il représente un point de distribution à partir duquel un package donné a été distribué aux clients.

La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes les propriétés héritées.

Syntaxe

Class SMS_DistributionPoint : SMS_BaseClass
{
      Boolean BitsEnabled;
      Boolean IsPeerDP;
      Boolean IsProtected;
      UInt8 ISVData[];
      UInt32 ISVDataSize;
      String ISVString;
      DateTime LastRefreshTime;
      UInt32 ObjectTypeID;
      String PackageID;
      UInt32 PackageType;
      Boolean RefreshNow;
      String ResourceType;
      String SecureObjectID;
      String ServerNALPath;
      String SiteCode;
      String SiteName;
      String SourceSite;
      UInt32 Status;
};

Méthodes

Le tableau suivant répertorie les méthodes de la SMS_DistributionPoint classe.

Méthode Description
Méthode VerifyPackage en classe SMS_DistributionPoint Vérifie l’intégrité du package.
Méthode CancelDistribution en classe SMS_DistributionPoint Annule la distribution d’un package.

Propriétés

BitsEnabled

Type de donnéesBoolean

Type d’accès : Lecture seule

Qualificatifs : [lire]

true si le point de distribution est compatible BITS. La valeur par défaut est false.

IsPeerDP

Type de donnéesBoolean

Type d’accès : Lecture seule

Qualificatifs : [lire]

true si le point de distribution est un point de distribution de branche. La valeur par défaut est false.

IsProtected

Type de donnéesBoolean

Type d’accès : Lecture seule

Qualificatifs : [lire]

true si le système de site du point de distribution est protégé. La valeur par défaut est false.

ISVData

Type de données : UInt8 tableau

Type d’accès : Lecture/écriture

Qualificatifs : [large, paresseux]

Les valeurs autorisent un seul éditeur de logiciels indépendant à stocker les données liées à l’objet de classe WMI SMS_Program Server associé au package. Pour plus d’informations, voir Remarques.

ISVDataSize

Type de donnéesUInt32

Type d’accès : Lecture/écriture

Qualificatifs : [paresseux]

Taille des données indiquée par ISVData. La valeur par défaut est 0.

ISVString

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : aucun

Chaîne pour l’extensibilité des partenaires.

LastRefreshTime

Type de donnéesDateTime

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Date et heure de la dernière mise à jour du package sur le serveur de distribution. La valeur par défaut est 19900101000000.000000+***.

ObjectTypeID

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [énumération, lire]

ID de classe d’objet sécurisé.

Valeur Type d’objet
2 SMS_Package
14 SMS_OperatingSystemInstallPackage
18 SMS_ImagePackage
19 SMS_BootImagePackage
23 SMS_DriverPackage
24 SMS_SoftwareUpdatesPackage
31 SMS_Application

PackageID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [clé]

ID du package qui a été distribué à ce point de distribution. La valeur par défaut est «  ».

PackageType

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [énumération, lire]

Type de package.

Valeur Description
0 Package de distribution de logiciels standard
3 Package de pilotes
4 Package de séquence de tâches
5 Package de mise à jour logicielle
6 Package de paramètres d’appareil
257 Package d’images
258 Package d’image de démarrage
259 Package de mise à niveau du système d’exploitation

RefreshNow

Type de donnéesBoolean

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

truepour signaler à Configuration Manager de mettre à jour le package sur le point de distribution. La mise à jour est spécifique au point de distribution et équivaut à l’action Actualiser le point de distribution dans la console du Configuration Manager. Cette mise à jour du package copie le contenu le plus récent de la source du package vers un point de distribution spécifique, afin que le point de distribution dispose de la dernière version. La version source du package n’est pas incrémentée et le contenu du package n’est pas répliqué sur des sites enfants. La valeur par défaut est false.

ResourceType

Type de donnéesString

Type d’accès : Lecture seule

Qualificatifs : [lire]

Type de ressource du point de distribution. La valeur par défaut est «  ».

SecureObjectID

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Clé d’objet de sécurité. Pour l’application, c’est CI_UniqueID. Pour package, il s’agit de PackageID.

ServerNALPath

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [clé]

Chemin de la couche d’abstraction réseau (NAL) vers le serveur de point de distribution. La valeur par défaut est «  ». Pour plus d’informations, voir Remarques.

SiteCode

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [key, SizeLimit(« 3 »)]

Code de site du site auquel appartient ce point de distribution. La valeur par défaut est «  ».

La valeur fournie pour cette propriété doit correspondre à la valeur de ServerNALPath. Votre application récupère la valeur de SMS_SystemResourceList classe WMI du serveur. Pour plus d’informations, voir Remarques.

SiteName

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificatifs : Aucun

Nom convivial du site d’où provient le colis. La valeur par défaut est «  ».

SourceSite

Type de donnéesString

Type d’accès : Lecture/écriture

Qualificateurs : [SizeLimit(« 3 »)]

Code de site du site d’où provient le package. La valeur par défaut est «  ».

Status

Type de donnéesUInt32

Type d’accès : Lecture seule

Qualificatifs : [lire, énumération]

Status actuel du package sur le point de distribution. Les valeurs possibles sont énumérées ci-dessous. Pour plus d’informations, voir Remarques.

Valeur status du package DP
0 AUCUN
1 MISE À JOUR
2 AJOUTÉ
3 SUPPRIMÉ

Remarques

Il n’y a pas de qualifications spéciales pour cette classe. Pour plus d’informations sur les qualificateurs de classe et de propriété inclus dans la section Propriétés, voir Qualificateurs de classe et de propriété du Configuration Manager.

Un point de distribution est toujours associé à un package particulier, et un package peut avoir plusieurs points de distribution.

Votre application ne peut pas modifier la PackageID propriété après la création du point de distribution. Pour associer le point de distribution à un package différent, l’application doit supprimer l’objet SMS_DistributionPoint et créer une nouvelle instance avec une nouvelle PackageID valeur.

La classe de classe WMI du serveur SMS_SystemResourceList contient une liste des points de distribution disponibles et leurs chemins d’accès au réseau d’adresses nationales. Votre application doit sélectionner la NALPath propriété de qui correspond à un RoleName paramètre de SMS_SystemResourceList propriété de « Point de distribution SMS ».

Lorsque votre application supprime une instance de SMS_DistributionPoint, l’instance n’est pas totalement supprimée tant que ses composants associés ne sont pas supprimés. Au lieu de cela, Configuration Manager définit la Status propriété sur 3 (supprimer) pour informer l’application que le point de distribution est marqué pour suppression. Pour vous assurer qu’une requête ne récupère pas les points de distribution qui ont été supprimés ou marqués pour suppression, votre application doit ajouter ce cas à sa clause WHERE.

Il n’existe aucune restriction ni format défini pour les données indiquées par ISVData. Cependant, il est important qu’une fois que la propriété ISV de cette propriété a été établie, elle ne soit pas écrasée. Par conséquent, l’application doit d’abord lire les données existantes dans cette propriété. Si les données n’appartiennent pas à l’appelant, elles ne doivent pas être modifiées. Tout éditeur de logiciels indépendant ou application qui utilise cette propriété doit inclure un identificateur dans les données afin que la propriété puisse être facilement établie.

Configuration requise

Configuration requise pour l’exécution

Pour plus d’informations, consultez Configuration requise pour l’exécution du serveur Configuration Manager.

Configuration requise pour le développement

Pour plus d’informations, voir Configuration requise pour le développement du serveur Configuration Manager.

Voir aussi