Classe WMI do servidor SMS_Advertisement

A SMS_Advertisement classe Windows Management Instrumentation (WMI) é uma classe de servidor do Fornecedor de SMS, no Configuration Manager, que representa um anúncio utilizado para anunciar programas de pacotes de software que estão disponíveis para execução em clientes.

A sintaxe seguinte é simplificada a partir do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

Class SMS_Advertisement : SMS_BaseClass
{
      UInt32 ActionInProgress;
      UInt32 AdvertFlags;
      String AdvertisementID;
      String AdvertisementName;
      SMS_ScheduleToken AssignedSchedule[];
      Boolean AssignedScheduleEnabled;
      Boolean AssignedScheduleIsGMT;
      UInt32 AssignmentID;
      String CollectionID;
      String Comment;
      UInt32 DeviceFlags;
      DateTime ExpirationTime;
      Boolean ExpirationTimeEnabled;
      Boolean ExpirationTimeIsGMT;
      String HierarchyPath;
      Boolean IncludeSubCollection;
      UInt8 ISVData[];
      UInt32 ISVDataSize;
      String ISVString;
      UInt32 MandatoryCountdown;
      UInt32 OfferType;
      String PackageID;
      DateTime PresentTime;
      Boolean PresentTimeEnabled;
      Boolean PresentTimeIsGMT;
      UInt32 Priority;
      String ProgramName;
      UInt32 RemoteClientFlags;
      String SourceSite;
      UInt32 TimeFlags;
};

Métodos

A tabela seguinte lista os métodos na SMS_Advertisement classe .

Propriedades

ActionInProgress

Tipo de dados: UInt32

Tipo de acesso: Só de leitura

Qualificadores: [leitura, enumeração]

A ação atual a ser executada no pacote por Configuration Manager. Os valores possíveis são:

AdvertFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: [bits]

Sinalizadores que indicam como o anúncio deve ser anunciado ao utilizador. Os valores possíveis estão listados abaixo. O valor padrão é 0.

Estes sinalizadores têm de ser coordenados com os sinalizadores especificados na ProgramFlags propriedade do programa anunciado. Por exemplo, se definir ONUSERLOGOFF, o sinalizador NOUSERLOGGEDIN no programa tem de ser definido. Se as definições do sinalizador não corresponderem, o programa não é anunciado. Para obter mais informações, veja Classe WMI de Servidor SMS_Program.

Definir IMEDIATO, ONUSERLOGON ou ONUSERLOGOFF ou fornecer um AssignedSchedule valor torna o programa anunciado obrigatório. Um programa obrigatório é executado automaticamente depois de o cliente receber o anúncio. O cliente não pode rejeitar ou adiar a instalação.

Defina os bits NO_DISPLAY e ONSLOWNET apenas quando o bit IMEDIATO, ONUSERLOGON ou ONUSERLOGOFF estiver definido ou o programa tiver um AssignedSchedule valor.

Defina NO_DISPLAY quando não pretender que o utilizador execute programas independentemente da atribuição. Se não definir este sinalizador, o anúncio é apresentado na lista de anúncios e pode ser executado independentemente da atribuição. O programa ainda pode ser obrigatório.

Defina ONSLOWNET quando as atribuições são obrigatórias através de uma ligação de rede lenta, por exemplo, quando um computador se liga através de um modem.

AdvertisementID

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: [chave, ResID(801), ResDLL("SMS_RSTT.dll")]

Chave gerada automaticamente exclusiva que identifica o anúncio. O valor predefinido é "".

AdvertisementName

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: [Not_null]

Nome exclusivo amigável para o anúncio.

AssignedSchedule Tipo de dados: SMS_ScheduleToken Matriz

Tipo de acesso: Leitura/Escrita

Qualificadores: [máx.(15), em diferido]

SMS_ScheduleToken objetos da Classe WMI de Servidor que indicam a hora em que o anúncio se torna obrigatório nos clientes.

AssignedScheduleEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true se a agenda definida na AssignedSchedule propriedade estiver ativa. O valor padrão é false.

AssignedScheduleIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true se a agenda definida na AssignedSchedule propriedade estiver na Hora da Métrica Universal (UMT). O valor padrão é false.

AssignmentID

Tipo de dados: UInt32

Tipo de acesso: Só de leitura

Qualificadores: [ler]

ID da atribuição associada ao anúncio.

CollectionID

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: [Not_null]

Coleção existente para a qual o anúncio é direcionado.

Comment

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Descrição simples ou nota sobre o anúncio. O valor predefinido é "".

DeviceFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Sinalizadores que descrevem o dispositivo. Os valores possíveis estão listados abaixo. O valor padrão é 0.

ExpirationTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Data e hora em que o anúncio já não está disponível para clientes. O valor predefinido é 19900101000000.000000+****.

ExpirationTimeEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true se o anúncio expirar no momento indicado pela ExpirationTime propriedade. O valor padrão é false.

ExpirationTimeIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true se a hora definida na ExpirationTime propriedade estiver no UMT. O valor padrão é false.

HierarchyPath

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Reservado.

IncludeSubCollection

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

true (predefinição) se o anúncio for anunciado para as subcoleções da coleção especificada.

ISVData

Tipo de dados: Uint8 Matriz

Tipo de acesso: Leitura/Escrita

Qualificadores: [grande, preguiçoso]

Informações que permitem que um único ISV armazene dados relacionados com uma SMS_Program instância. Não existem restrições ou formatos definidos para estes dados. No entanto, é importante não substituir a propriedade depois de a propriedade ISV ter sido estabelecida. Por conseguinte, a aplicação de chamada deve ler primeiro os dados existentes nesta propriedade. Se os dados não pertencerem à aplicação, não devem ser modificados. Qualquer ISV ou proprietário da aplicação que esteja a utilizar esta propriedade deve incluir um identificador nos dados para que a propriedade possa ser facilmente estabelecida.

ISVDataSize

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

O tamanho dos dados representados ISVData pela propriedade . O valor padrão é 0.

ISVString

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: nenhum

Cadeia de carateres para extensibilidade de parceiros.

MandatoryCountdown

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Duração, em minutos, para mostrar a contagem decrescente obrigatória da notificação do utilizador de implementação do sistema operativo. O valor padrão é 0.

OfferType

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: [enumeração]

Tipo de anúncio que indica que o anúncio é direcionado para os utilizadores.

PackageID

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: [Not_null]

ID de um pacote existente associado ao anúncio. O valor tem de estar em maiúsculas.

PresentTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Escrita

Qualificadores: Nenhum

Data e hora em que o anúncio é disponibilizado aos clientes. O valor predefinido é 19900101000000.000000+****.

PresentTimeEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true(predefinição) se a hora atual for imposta por Configuration Manager.

PresentTimeIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Escrita

Qualificadores: [preguiçoso]

true se a hora definida na PresentTime propriedade estiver no UMT. O valor padrão é false.

Priority

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: [enumeração]

A prioridade utilizada na replicação do anúncio para sites subordinados. Os valores possíveis estão listados abaixo. O valor predefinido é NORMAL (2).

ProgramName

Tipo de dados: String

Tipo de acesso: Leitura/Escrita

Qualificadores: [Not_null]

Um programa dentro do pacote especificado (PackageID) a anunciar.

RemoteClientFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Escrita

Qualificadores: [bits]

Sinalizadores que especificam como o programa deve ser executado quando o cliente está ligado localmente ou remotamente a um ponto de distribuição. Os valores possíveis estão listados abaixo. O valor predefinido é 48.

SourceSite

Tipo de dados: String

Tipo de acesso: Só de leitura

Qualificadores: [ler]

Código de site de três letras do site de origem do anúncio.

TimeFlags

Tipo de dados: UInt32

Tipo de acesso: Só de leitura

Qualificadores: [leitura, bits]

Reservado para uso interno. Sinalizadores que duplicam as informações nas propriedades relacionadas com o tempo. Os valores possíveis estão listados abaixo. Por exemplo, ENABLE_PRESENT é definido quando PresentTimeEnabled é igual a true.

Comentários

Os qualificadores de classe para esta classe incluem:

• Protegido

  Para obter mais informações sobre os qualificadores de classe e os qualificadores de propriedade incluídos na secção Propriedades, consulte Configuration Manager Classificadores de Classe e Propriedade.

  Embora não existam outras propriedades de chave, as propriedades AdvertisementName, CollectionID, PackageIDe ProgramName são qualificadas como NOT_NULL e os valores têm de ser fornecidos. A aplicação não pode atualizar estas propriedades depois de uma instância de classe ser criada. Para alterar estes valores, a aplicação tem de eliminar a instância e criar uma nova instância com os valores corretos.

Requisitos

Requisitos de runtime

Para obter mais informações, veja Configuration Manager Server Runtime Requirements (Requisitos de Runtime do Servidor do Configuration Manager).

Requisitos de desenvolvimento

Para obter mais informações, veja Requisitos de Desenvolvimento do Configuration Manager Server.