Classe WMI do servidor SMS_DistributionPoint
A SMS_DistributionPoint classe WMI é uma classe de servidor provedor de SMS no Configuration Manager. Ele representa um ponto de distribuição do qual um determinado pacote foi distribuído aos clientes.
A sintaxe a seguir é simplificada do código MOF (Formato de Objeto Gerenciado) e inclui todas as propriedades herdadas.
Sintaxe
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étodos
A tabela a seguir lista os métodos na SMS_DistributionPoint classe.
| Método | Descrição |
|---|---|
| Método VerifyPackage na classe SMS_DistributionPoint | Verifica a integridade do pacote. |
| Método CancelDistribution na classe SMS_DistributionPoint | Cancela a distribuição de um pacote. |
Propriedades
BitsEnabled
Tipo de dados: Boolean
Tipo de acesso: somente leitura
Qualificadores: [leia]
true se o ponto de distribuição estiver habilitado para BITS. O valor padrão é false.
IsPeerDP
Tipo de dados: Boolean
Tipo de acesso: somente leitura
Qualificadores: [leia]
true se o ponto de distribuição for um ponto de distribuição de branch. O valor padrão é false.
IsProtected
Tipo de dados: Boolean
Tipo de acesso: somente leitura
Qualificadores: [leia]
true se o sistema de site de ponto de distribuição estiver protegido. O valor padrão é false.
ISVData
Tipo de dados: UInt8 Matriz
Tipo de acesso: Leitura/Gravação
Qualificadores: [grande, preguiçoso]
Os valores permitem que um único ISV armazene dados relacionados ao objeto classe WMI do servidor SMS_Program associado ao pacote. Para obter mais informações, consulte Comentários.
ISVDataSize
Tipo de dados: UInt32
Tipo de acesso: Leitura/Gravação
Qualificadores: [preguiçoso]
O tamanho dos dados indicados por ISVData. O valor padrão é 0.
ISVString
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: nenhum
Cadeia de caracteres para extensibilidade de parceiro.
LastRefreshTime
Tipo de dados: DateTime
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Data e hora de quando o pacote foi atualizado pela última vez no servidor de distribuição. O valor padrão é 19900101000000.000000+***.
ObjectTypeID
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [enumeração, leitura]
ID da classe de objeto protegido.
| Valor | Tipo de objeto |
|---|---|
| 2 | SMS_Package |
| 14 | SMS_OperatingSystemInstallPackage |
| 18 | SMS_ImagePackage |
| 19 | SMS_BootImagePackage |
| 23 | SMS_DriverPackage |
| 24 | SMS_SoftwareUpdatesPackage |
| 31 | SMS_Application |
PackageID
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [chave]
ID do pacote que foi distribuído para este ponto de distribuição. O valor padrão é "".
PackageType
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [enumeração, leitura]
O tipo de pacote.
| Valor | Descrição |
|---|---|
| 0 | Pacote de distribuição de software regular |
| 3 | Pacote driver |
| 4 | Pacote de sequência de tarefas |
| 5 | Pacote de atualização de software |
| 6 | Pacote de configuração do dispositivo |
| 257 | Pacote de imagem |
| 258 | Pacote de imagem de inicialização |
| 259 | Pacote de atualização do sistema operacional |
RefreshNow
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
truepara sinalizar Configuration Manager para atualizar o pacote no ponto de distribuição. A atualização é específica do ponto de distribuição e é equivalente à ação Ponto de Distribuição de Atualização no console Configuration Manager. Essa atualização de pacote copia o conteúdo mais recente da origem do pacote para um ponto de distribuição específico, de modo que o ponto de distribuição tenha a versão mais recente. A versão de origem do pacote não é incrementada e o conteúdo do pacote não é replicado em sites filho. O valor padrão é false.
ResourceType
Tipo de dados: String
Tipo de acesso: somente leitura
Qualificadores: [leia]
O tipo de recurso do ponto de distribuição. O valor padrão é "".
SecureObjectID
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Chave de objeto de segurança. Para aplicativo, é CI_UniqueID. Para pacote, é PackageID.
ServerNALPath
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [chave]
Caminho da NAL (camada de abstração de rede) para o servidor de ponto de distribuição. O valor padrão é "". Para obter mais informações, consulte Comentários.
SiteCode
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [key, SizeLimit("3")]
Código do site ao qual esse ponto de distribuição pertence. O valor padrão é "".
O valor fornecido para essa propriedade deve corresponder ao valor de ServerNALPath. Seu aplicativo recupera o valor da classe WMI do servidor SMS_SystemResourceList. Para obter mais informações, consulte Comentários.
SiteName
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Nome amigável do site de origem do pacote. O valor padrão é "".
SourceSite
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [SizeLimit("3")]
Código do site do local em que o pacote é originado. O valor padrão é "".
Status
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [leitura, enumeração]
Status atual do pacote no ponto de distribuição. Os valores possíveis estão listados abaixo. Para obter mais informações, consulte Comentários.
| Valor | Status do pacote DP |
|---|---|
| 0 | NENHUM |
| 1 | ATUALIZADO |
| 2 | ADICIONADO |
| 3 | EXCLUÍDO |
Comentários
Não há qualificadores de classe especiais para esta classe. Para obter mais informações sobre os qualificadores de classe e as qualificatórias de propriedade incluídas na seção Propriedades, consulte Configuration Manager classificadores de classe e propriedade.
Um ponto de distribuição sempre está associado a um pacote específico e um pacote pode ter vários pontos de distribuição.
Seu aplicativo não pode alterar a PackageID propriedade após a criação do ponto de distribuição. Para associar o ponto de distribuição a um pacote diferente, o aplicativo deve excluir o SMS_DistributionPoint objeto e criar uma nova instância com um novo PackageID valor.
A classe WMI do servidor SMS_SystemResourceList contém uma lista dos pontos de distribuição disponíveis e seus caminhos NAL. Seu aplicativo deve selecionar a NALPath propriedade do SMS_SystemResourceList que corresponde a uma RoleName configuração de propriedade de "Ponto de Distribuição sms".
Quando seu aplicativo exclui uma instância de SMS_DistributionPoint, a instância não é totalmente excluída até que seus componentes relacionados sejam excluídos. Em vez disso, Configuration Manager define a Status propriedade como 3 (excluir) para informar ao aplicativo que o ponto de distribuição está marcado para exclusão. Para garantir que uma consulta não recupere pontos de distribuição que foram excluídos ou marcados para exclusão, seu aplicativo deve adicionar esse caso à cláusula WHERE.
Não há restrições ou formatos definidos para os dados indicados por ISVData. No entanto, é importante que, depois que a propriedade ISV dessa propriedade tiver sido estabelecida, ela não deve ser substituída. Portanto, o aplicativo deve primeiro ler os dados existentes nesta propriedade. Se os dados não pertencerem ao chamador, eles não devem ser modificados. Qualquer ISV ou aplicativo que esteja usando essa propriedade deve incluir um identificador nos dados para que a propriedade possa ser facilmente estabelecida.
Requisitos
Requisitos de runtime
Para obter mais informações, consulte Configuration Manager requisitos de runtime do servidor.
Requisitos de desenvolvimento
Para obter mais informações, consulte Configuration Manager requisitos de desenvolvimento do servidor.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de