SMS_DistributionPoint classe WMI du serveur
La SMS_DistributionPoint classe WMI est une classe de serveur du fournisseur SMS dans 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 dans la classe SMS_DistributionPoint | Vérifie l’intégrité du package. |
| Méthode CancelDistribution dans la classe SMS_DistributionPoint | Annule la distribution d’un package. |
Propriétés
BitsEnabled
Type de donnéesBoolean
Type d’accès : en lecture seule
Qualificateurs : [read]
true si le point de distribution est activé pour BITS. La valeur par défaut est false.
IsPeerDP
Type de donnéesBoolean
Type d’accès : en lecture seule
Qualificateurs : [read]
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 : en lecture seule
Qualificateurs : [read]
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
Qualificateurs : [large, paresseux]
Les valeurs permettent à un éditeur de logiciels indépendant de stocker des données liées à l’objet de classe WMI SMS_Program Server associé au package. Pour plus d’informations, consultez Remarques.
ISVDataSize
Type de donnéesUInt32
Type d’accès : Lecture/écriture
Qualificateurs : [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
Qualificateurs : aucun
Chaîne pour l’extensibilité du partenaire.
LastRefreshTime
Type de donnéesDateTime
Type d’accès : Lecture/écriture
Qualificateurs : 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 : en lecture seule
Qualificateurs : [énumération, lecture]
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 : [key]
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 : en lecture seule
Qualificateurs : [énumération, lecture]
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
Qualificateurs : Aucun
truepour signaler Configuration Manager 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 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 ait 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 les sites enfants. La valeur par défaut est false.
ResourceType
Type de donnéesString
Type d’accès : en lecture seule
Qualificateurs : [read]
Type de ressource du point de distribution. La valeur par défaut est « ».
SecureObjectID
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Clé d’objet de sécurité. Pour l’application, il est CI_UniqueID. Pour le package, il s’agit de PackageID.
ServerNALPath
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : [key]
Chemin d’accès de la couche d’abstraction réseau (NAL) au serveur de point de distribution. La valeur par défaut est « ». Pour plus d’informations, consultez 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 à partir de SMS_SystemResourceList classe WMI du serveur. Pour plus d’informations, consultez Remarques.
SiteName
Type de donnéesString
Type d’accès : Lecture/écriture
Qualificateurs : Aucun
Nom convivial du site d’origine du package. 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 : en lecture seule
Qualificateurs : [read, énumération]
État actuel du package sur le point de distribution. Les valeurs possibles sont répertoriées ci-dessous. Pour plus d’informations, consultez Remarques.
| Valeur | État du package DP |
|---|---|
| 0 | AUCUN |
| 1 | ACTUALISÉ |
| 2 | AJOUTÉ |
| 3 | SUPPRIMÉ |
Remarques
Il n’existe aucun qualificateur de classe spécial pour cette classe. Pour plus d’informations sur les qualificateurs de classe et les qualificateurs de propriété inclus dans la section Propriétés, consultez Configuration Manager qualificateurs de classe et de propriété.
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 autre package, l’application doit supprimer l’objet SMS_DistributionPoint et créer une instance avec une nouvelle PackageID valeur.
La classe de classe WMI du serveur SMS_SystemResourceList contient une liste des points de distribution disponibles et de leurs chemins d’accès réseau. Votre application doit sélectionner la NALPath propriété de SMS_SystemResourceList qui correspond à un RoleName paramètre de propriété « 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 n’ont pas été 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 ou format défini pour les données indiquées par ISVData. Toutefois, il est important qu’une fois que la propriété isV de cette propriété a été établie, elle ne doit pas être remplacé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épendants ou toute 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
Conditions requises pour le runtime
Pour plus d’informations, consultez Configuration Manager configuration requise pour le runtime du serveur.
Exigences de développement
Pour plus d’informations, consultez Configuration Manager configuration requise pour le développement du serveur.
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour