Classe WMI do servidor SMS_Advertisement

A SMS_Advertisement classe WMI (Instrumentação de Gerenciamento do Windows) é uma classe de servidor de provedor SMS, no Configuration Manager, que representa um anúncio usado para anunciar programas de pacote de software disponíveis para execução em clientes.

A sintaxe a seguir é simplificada 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 a seguir lista os métodos da SMS_Advertisement classe.

Propriedades

ActionInProgress

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [read, enumeration]

Ação atual sendo executada no pacote pelo Configuration Manager. Os valores possíveis são:

AdvertFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: [bits]

Sinalizadores indicando como o anúncio deve ser anunciado ao usuário. Os valores possíveis estão listados abaixo. O valor padrão é 0.

Esses sinalizadores devem ser coordenados com os sinalizadores especificados na ProgramFlags propriedade do programa anunciado. Por exemplo, se você configurar ONUSERLOGOFF, o sinalizador NOUSERLOGGEDIN no programa deverá ser definido. Se as configurações do sinalizador não corresponderem, o programa não será anunciado. Para obter mais informações, consulte Classe WMI do SMS_Program Server.

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

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

Defina NO_DISPLAY quando não desejar que o usuário execute programas independentemente da atribuição. Se você não definir esse sinalizador, o anúncio será mostrado na lista de anúncios e poderá ser executado independentemente da atribuição. O programa ainda pode ser obrigatório.

Configure ONSLOWNET quando as atribuições forem obrigatórias em uma conexão de rede lenta, por exemplo, quando um computador se conectar usando um modem.

AdvertisementID

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

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

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

AdvertisementName

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Not_null]

Nome exclusivo e amigável para o anúncio.

AssignedSchedule Tipo de dados: SMS_ScheduleToken matriz

Tipo de acesso: Leitura/Gravação

Qualificadores: [max(15), preguiçoso]

SMS_ScheduleToken Objetos de classe WMI do servidor que indicam a hora em que o anúncio se torna obrigatório para os clientes.

AssignedScheduleEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true Se o horário definido na AssignedSchedule propriedade estiver ativo. O valor padrão é false.

AssignedScheduleIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true se o agendamento definido na AssignedSchedule propriedade estiver em Tempo Métrico Universal (UMT). O valor padrão é false.

AssignmentID

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

CollectionID

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Not_null]

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

Comment

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Descrição simples ou observação sobre o anúncio. O valor padrão é "".

DeviceFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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/Gravação

Classificatórias: Nenhuma

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

ExpirationTimeEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true Se o anúncio expirar no horário indicado pela ExpirationTime propriedade. O valor padrão é false.

ExpirationTimeIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true se o tempo definido na ExpirationTime propriedade estiver em UMT. O valor padrão é false.

HierarchyPath

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Reservado.

IncludeSubCollection

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

true (padrã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/Gravação

Eliminatórias: [grande, preguiçoso]

Informações que permitem que um único ISV armazene dados relacionados a uma SMS_Program instância. Não há restrições ou formatos definidos para esses dados. No entanto, é importante não substituir a propriedade depois que sua propriedade ISV for estabelecida. Portanto, o aplicativo de chamada deve ler os dados existentes nessa propriedade primeiro. Se os dados não pertencerem ao aplicativo, eles não devem ser modificados. Qualquer ISV ou proprietário de aplicativo que esteja usando essa propriedade deve incluir um identificador nos dados para que a propriedade possa ser facilmente estabelecida.

ISVDataSize

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

O tamanho dos dados representados pela ISVData propriedade. 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.

MandatoryCountdown

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

Duração, em minutos, para mostrar a contagem regressiva obrigatória do agendamento de notificação do usuário de implantação do sistema operacional. O valor padrão é 0.

OfferType

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificadores: [enumeração]

Tipo de anúncio que indica que o anúncio é direcionado aos usuários.

PackageID

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Not_null]

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

PresentTime

Tipo de dados: DateTime

Tipo de acesso: Leitura/Gravação

Classificatórias: Nenhuma

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

PresentTimeEnabled

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true(padrão) se a hora atual for imposta pelo Configuration Manager.

PresentTimeIsGMT

Tipo de dados: Boolean

Tipo de acesso: Leitura/Gravação

Qualificatórias: [preguiçoso]

true se o tempo definido na PresentTime propriedade estiver em UMT. O valor padrão é false.

Priority

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Qualificadores: [enumeração]

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

ProgramName

Tipo de dados: String

Tipo de acesso: Leitura/Gravação

Eliminatórias: [Not_null]

Um programa dentro do pacote especificado (PackageID) a ser anunciado.

RemoteClientFlags

Tipo de dados: UInt32

Tipo de acesso: Leitura/Gravação

Classificatórias: [bits]

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

SourceSite

Tipo de dados: String

Tipo de acesso: somente leitura

Eliminatórias: [leia]

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

TimeFlags

Tipo de dados: UInt32

Tipo de acesso: somente leitura

Qualificadores: [leia-se, bits]

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

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 seção Propriedades, consulte Qualificadores de classe e propriedade do Configuration Manager.

  Embora não haja outras propriedades principais, as propriedades AdvertisementName, CollectionID, PackageID, e ProgramName são qualificadas como NOT_NULL e os valores devem ser fornecidos. Seu aplicativo não pode atualizar essas propriedades depois que uma instância de classe é criada. Para alterar esses valores, o aplicativo deve excluir a instância e criar uma nova instância com os valores corretos.

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.