Classe WMI do servidor SMS_DistributionPoint

A SMS_DistributionPoint classe WMI é uma classe de servidor de provedor SMS no Configuration Manager. Ele representa um ponto de distribuição a partir do qual um determinado pacote foi distribuído aos clientes.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) 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 da 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

Eliminatórias: [leia]

true se o ponto de distribuição for habilitado para BITS. O valor padrão é false.

IsPeerDP

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Eliminatórias: [leia]

true se o ponto de distribuição for um ponto de distribuição de filial. O valor padrão é false.

IsProtected

Tipo de dados: Boolean

Tipo de acesso: somente leitura

Eliminatórias: [leia]

true Se o sistema de sites do ponto de distribuição estiver protegido. O valor padrão é false.

ISVData

Tipo de dados: UInt8 matriz

Tipo de acesso: Leitura/Gravação

Eliminatórias: [grande, preguiçoso]

Os valores permitem que um único ISV armazene dados relacionados ao objeto de classe WMI do SMS_Program Server associado ao pacote. Para obter mais informações, consulte Comentários.

ISVDataSize

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

O tamanho dos dados indicado por ISVData. O valor padrão é 0.

ISVString

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: nenhuma

Cadeia de caracteres para extensibilidade do parceiro.

LastRefreshTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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

Classificatórias: [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 de 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 imagens
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

Classificatórias: Nenhuma

truepara sinalizar ao 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 Atualizar Ponto de Distribuição no console do Configuration Manager. Esta atualização de pacote copia o conteúdo mais recente da origem do pacote para um ponto de distribuição específico, para 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 para sites filho. O valor padrão é false.

ResourceType

Tipo de dados: String

Tipo de acesso: somente leitura

Eliminatórias: [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

Classificatórias: Nenhuma

Chave de objeto de segurança. Para aplicação, é CI_UniqueID. Para pacote, é PackageID.

ServerNALPath

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: [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 este ponto de distribuição pertence. O valor padrão é "".

O valor fornecido para esta propriedade deve corresponder ao valor de ServerNALPath. O aplicativo recupera o valor da classe WMI SMS_SystemResourceList servidor. Para obter mais informações, consulte Comentários.

SiteName

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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 de onde o pacote se origina. O valor padrão é "".

Status

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [read, enumeration]

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 especial para esta classe. Para obter mais informações sobre os qualificadores de classe e os qualificadores de propriedade incluídos na seção Propriedades, consulte Qualificadores de classe e propriedade do Configuration Manager.

Um ponto de distribuição está sempre 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 de 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 que corresponde a uma RoleName configuração de SMS_SystemResourceList propriedade de "Ponto de Distribuição de 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, o 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 for estabelecida, ela não seja substituída. Portanto, o aplicativo deve primeiro ler os dados existentes nessa 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 tempo de execução

Para obter mais informações, consulte Requisitos de tempo de execução do servidor do Configuration Manager.

Requisitos de desenvolvimento

Para obter mais informações, consulte Requisitos de desenvolvimento de servidor do Configuration Manager.

Confira também