classe WMI del server SMS_DistributionPoint
La SMS_DistributionPoint
classe WMI è una classe server del provider SMS in Configuration Manager. Rappresenta un punto di distribuzione da cui un determinato pacchetto è stato distribuito ai client.
La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate.
Sintassi
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;
};
Metodi
Nella tabella seguente sono elencati i metodi nella SMS_DistributionPoint
classe .
Metodo | Descrizione |
---|---|
Metodo VerifyPackage nella classe SMS_DistributionPoint | Verifica l'integrità del pacchetto. |
Metodo CancelDistribution nella classe SMS_DistributionPoint | Annulla la distribuzione di un pacchetto. |
Proprietà
BitsEnabled
Tipo di dati:Boolean
Tipo di accesso: sola lettura
Qualificatori: [read]
true
se il punto di distribuzione è abilitato per BITS. Il valore predefinito è false
.
IsPeerDP
Tipo di dati:Boolean
Tipo di accesso: sola lettura
Qualificatori: [read]
true
se il punto di distribuzione è un punto di distribuzione di ramo. Il valore predefinito è false
.
IsProtected
Tipo di dati:Boolean
Tipo di accesso: sola lettura
Qualificatori: [read]
true
se il sistema del sito del punto di distribuzione è protetto. Il valore predefinito è false
.
ISVData
Tipo di dati: UInt8
Matrice
Tipo di accesso: lettura/scrittura
Qualificatori: [grande, pigro]
I valori consentono a un singolo ISV di archiviare i dati correlati all'oggetto classe WMI SMS_Program Server associato al pacchetto. Per altre informazioni, vedere Osservazioni.
ISVDataSize
Tipo di dati:UInt32
Tipo di accesso: lettura/scrittura
Qualificatori: [lazy]
Dimensioni dei dati indicati da ISVData
. Il valore predefinito è 0.
ISVString
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: nessuno
Stringa per l'estendibilità del partner.
LastRefreshTime
Tipo di dati:DateTime
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Data e ora dell'ultimo aggiornamento del pacchetto nel server di distribuzione. Il valore predefinito è 19900101000000.000000+***
.
ObjectTypeID
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [enumerazione, lettura]
ID classe oggetto protetto.
Valore | Tipo di oggetto |
---|---|
2 | SMS_Package |
14 | SMS_OperatingSystemInstallPackage |
18 | SMS_ImagePackage |
19 | SMS_BootImagePackage |
23 | SMS_DriverPackage |
24 | SMS_SoftwareUpdatesPackage |
31 | SMS_Application |
PackageID
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [chiave]
ID per il pacchetto distribuito a questo punto di distribuzione. Il valore predefinito è "".
PackageType
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [enumerazione, lettura]
Tipo di pacchetto.
Valore | Descrizione |
---|---|
0 | Normale pacchetto di distribuzione software |
3 | Pacchetto driver |
4 | Pacchetto della sequenza di attività |
5 | Pacchetto di aggiornamento software |
6 | Pacchetto di impostazione del dispositivo |
257 | Pacchetto immagine |
258 | Pacchetto immagine di avvio |
259 | Pacchetto di aggiornamento del sistema operativo |
RefreshNow
Tipo di dati:Boolean
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
true
per segnalare Configuration Manager di aggiornare il pacchetto nel punto di distribuzione. L'aggiornamento è specifico del punto di distribuzione ed è equivalente all'azione Aggiorna punto di distribuzione nella console di Configuration Manager. Questo aggiornamento del pacchetto copia il contenuto più recente dall'origine del pacchetto a un punto di distribuzione specifico, in modo che il punto di distribuzione abbia la versione più recente. La versione di origine del pacchetto non viene incrementata e il contenuto del pacchetto non viene replicato nei siti figlio. Il valore predefinito è false
.
ResourceType
Tipo di dati:String
Tipo di accesso: sola lettura
Qualificatori: [read]
Tipo di risorsa del punto di distribuzione. Il valore predefinito è "".
SecureObjectID
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Chiave dell'oggetto di sicurezza. Per l'applicazione, è CI_UniqueID. Per il pacchetto, è PackageID.
ServerNALPath
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [chiave]
Percorso del livello di astrazione di rete (NAL) del server del punto di distribuzione. Il valore predefinito è "". Per altre informazioni, vedere Osservazioni.
SiteCode
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [key, SizeLimit("3")]
Codice del sito a cui appartiene questo punto di distribuzione. Il valore predefinito è "".
Il valore fornito per questa proprietà deve corrispondere al valore di ServerNALPath
. L'applicazione recupera il valore da SMS_SystemResourceList classe WMI del server. Per altre informazioni, vedere Osservazioni.
SiteName
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: Nessuno
Nome descrittivo del sito di origine del pacchetto. Il valore predefinito è "".
SourceSite
Tipo di dati:String
Tipo di accesso: lettura/scrittura
Qualificatori: [SizeLimit("3")]
Codice del sito in cui ha origine il pacchetto. Il valore predefinito è "".
Status
Tipo di dati:UInt32
Tipo di accesso: sola lettura
Qualificatori: [lettura, enumerazione]
Stato corrente del pacchetto nel punto di distribuzione. Di seguito sono elencati i valori possibili. Per altre informazioni, vedere Osservazioni.
Valore | Stato del pacchetto DP |
---|---|
0 | NESSUNO |
1 | AGGIORNATO |
2 | AGGIUNTO |
3 | ELIMINATO |
Osservazioni
Non sono presenti qualificatori di classe speciali per questa classe. Per altre informazioni sui qualificatori di classe e sui qualificatori di proprietà inclusi nella sezione Proprietà, vedere Configuration Manager qualificatori di classe e proprietà.
Un punto di distribuzione è sempre associato a un pacchetto specifico e un pacchetto può avere diversi punti di distribuzione.
L'applicazione non può modificare la PackageID
proprietà dopo la creazione del punto di distribuzione. Per associare il punto di distribuzione a un pacchetto diverso, l'applicazione deve eliminare l'oggetto SMS_DistributionPoint
e creare una nuova istanza con un nuovo PackageID
valore.
La classe WMI del server SMS_SystemResourceList contiene un elenco dei punti di distribuzione disponibili e dei relativi percorsi NAL. L'applicazione deve selezionare la NALPath
proprietà di SMS_SystemResourceList
che corrisponde a un'impostazione RoleName
della proprietà "PUNTO di distribuzione SMS".
Quando l'applicazione elimina un'istanza di SMS_DistributionPoint
, l'istanza non viene eliminata completamente fino a quando i relativi componenti correlati non vengono eliminati. Invece, Configuration Manager imposta la Status
proprietà su 3 (eliminazione) per informare l'applicazione che il punto di distribuzione è contrassegnato per l'eliminazione. Per assicurarsi che una query non recuperi i punti di distribuzione eliminati o contrassegnati per l'eliminazione, l'applicazione deve aggiungere questo caso alla clausola WHERE.
Non esistono restrizioni o formati definiti per i dati indicati da ISVData
. Tuttavia, è importante che, dopo che è stata stabilita la proprietà ISV di questa proprietà, non debba essere sovrascritta. Pertanto, l'applicazione deve prima leggere i dati esistenti in questa proprietà. Se i dati non appartengono al chiamante, non devono essere modificati. Qualsiasi ISV o applicazione che usa questa proprietà deve includere un identificatore nei dati in modo che la proprietà possa essere facilmente stabilita.
Requisiti
Requisiti di runtime
Per altre informazioni, vedere Configuration Manager requisiti di runtime del server.
Requisiti di sviluppo
Per altre informazioni, vedere Configuration Manager requisiti di sviluppo del server.