SMS_Advertisement server WMI class (Classe WMI de servidor SMS_Advertisement)
A SMS_Advertisement classe Windows Management Instrumentation (WMI) é uma classe de servidores de FORNECEDORES DE SMS, em Gestor de Configuração, que representa um anúncio usado para anunciar programas de pacotes de software que estão disponíveis para executar em clientes.
A seguinte sintaxe é simplificada a partir do código do formato MOF (Managed Object Format) e inclui todas as propriedades herdadas.
Syntax
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 que se segue lista os métodos da SMS_Advertisement classe.
| Método | Descrição |
|---|---|
| Método GetAdvertisements na Classe SMS_Advertisement | Obtém as identidades de anúncio que são direcionadas para o recurso. |
| Método GetNextID na Classe SMS_Advertisement | Recupera o número de ID que será usado para o próximo anúncio criado. |
| Método RiskyDeploymentStatusMessage na Classe SMS_Advertisement | Envia uma mensagem de estado de aviso sobre a implementação de um utilizador para uma recolha arriscada. |
| Método SetNextID na Classe SMS_Advertisement | Define o número de ID que será usado para o próximo anúncio criado. |
| Método SetSourceSite na Classe SMS_Advertisement | Define o código do site de origem para o anúncio. |
| Método Unlock na Classe SMS_Advertisement | Define o site de origem para o site atual, desbloqueando o anúncio. Aviso: Este método é precotado. |
Propriedades
ActionInProgress
Tipo de dados: UInt32
Tipo de acesso: Só de leitura
Eliminatórias: [ler, enumerar]
A ação atual está a ser executada no pacote pelo Gestor de Configuração. Os valores possíveis são:
| Valor | Descrição |
|---|---|
| 0 | NENHUMA |
| 1 | UPDATE |
| 2 | ADICIONAR |
AdvertFlags
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Qualificadores: [bits]
Bandeiras que indicam como o anúncio deve ser anunciado ao utilizador. Os valores possíveis estão listados abaixo. O valor predefinido é 0.
| Hexadecimal (Bit) | Description |
|---|---|
| 0x00000020 (5) | IMEDIATAMENTE. Anuncie o anúncio ao utilizador imediatamente. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Anuncie o anúncio ao utilizador no arranque do sistema. |
| 0x00000200 (9) | O ONUSERLOGON. Anuncie o anúncio ao utilizador em início de s. |
| 0x00000400 (10) | O ONUSERLOGOFF. Anuncie o anúncio ao utilizador no logoff. |
| 0x00001000 (12) | OPCIONALPREDOWNLOAD. Se a arquitetura e o idioma selecionados corresponderem ao do cliente, o conteúdo do pacote será descarregado com antecedência |
| 0x00008000 (15) | WINDOWS_CE. O anúncio é para um cliente do dispositivo. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Esta informação aplica-se a System Center Gestor de Configuração SP1 ou posteriormente, e System Center Gestor de Configuração R2 de 2012 ou posterior. |
| 0x00020000 (17) | DONOT_FALLBACK. Não recue para pontos de distribuição desprotegidos. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. A sequência de tarefas está disponível para meios amovíveis e o ponto de serviço de execução pré-arranque (PXE). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Substitua as janelas de manutenção ao anunciar o anúncio ao utilizador. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Reinicie fora das janelas de manutenção. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Anuncie o anúncio ao utilizador com Wake On LAN ativado. |
| 0x00800000 (23) | SHOW_PROGRESS. Anuncie o anúncio ao utilizador mostrando o progresso da sequência de tarefas. |
| 0x02000000 (25) | NO_DISPLAY. O utilizador não deve executar programas independentemente da atribuição. |
| 0x04000000 (26) | NA ONSLOWNET. As atribuições são obrigatórias sobre uma ligação de rede lenta. |
| 0x10000000 (28) | TARGETTOWINPE. Direcione esta implantação apenas para WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Direcione esta implementação apenas para WinPE, mas esconda-se no WinPE. Só pode ser utilizado pela variável TS SMSTSPreferredAdvertID. |
Estas bandeiras devem ser coordenadas com as bandeiras especificadas na ProgramFlags propriedade do programa anunciado. Por exemplo, se definir ONUSERLOGOFF, a bandeira NOUSERLOGGEDIN no programa deve ser definida. Se as definições da bandeira não corresponderem, o programa não é anunciado. Para obter mais informações, consulte SMS_Program Classe WMI do servidor.
Definir IMEDIATO, ONUSERLOGON ou ONUSERLOGOFF ou fornecer um AssignedSchedule valor torna obrigatório o programa anunciado. Um programa obrigatório é executado automaticamente após o cliente ter recebido o anúncio. O cliente não pode rejeitar ou adiar a instalação.
Desa estatueta as NO_DISPLAY e as bits ONSLOWNET apenas quando a bit IMEDIATA, ONUSERLOGON ou ONUSERLOGOFF estiver definida ou o programa tiver um AssignedSchedule valor.
Desa esta NO_DISPLAY quando não pretender que o utilizador execute programas independentemente da atribuição. Se não definir esta bandeira, o anúncio é mostrado na lista de anúncios e pode ser executado independentemente da atribuição. O programa ainda pode ser obrigatório.
Desajuste ONSLOWNET quando as atribuições são obrigatórias sobre uma ligação de rede lenta, por exemplo, quando um computador se conecta usando um modem.
AdvertisementID
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [chave, ResID(801), ResDLL ("SMS_RSTT.dll")]
Chave auto-gerada única que identifica o anúncio. O valor predefinido é "".
AdvertisementName
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [Not_null]
Nome único para o utilizador para o anúncio.
AssignedSchedule
Tipo de dados: Matriz SMS_ScheduleToken
Tipo de acesso: Leitura/Escrita
Qualificadores: [máx(15), em diferido]
SMS_ScheduleToken objetos da Classe WMI do servidor indicando a hora em que o anúncio se torna obrigatório para os clientes.
AssignedScheduleEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true se o horário definido na AssignedSchedule propriedade estiver ativo. O valor predefinido é false.
AssignedScheduleIsGMT
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true se o calendário definido na AssignedSchedule propriedade estiver em Tempo Métrico Universal (UMT). O valor predefinido é false.
AssignmentID
Tipo de dados: UInt32
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
Identificação da atribuição associada ao anúncio.
CollectionID
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [Not_null]
Coleção existente para a qual o anúncio é dirigido.
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
Bandeiras descrevendo o dispositivo. Os valores possíveis estão listados abaixo. O valor predefinido é 0.
| Hexadecimal (Bit) | Description |
|---|---|
| 0x01000000 (24) | Atribua sempre o programa ao cliente. |
| 0x02000000 (25) | Atribua apenas se o dispositivo estiver atualmente ligado a uma ligação de largura de banda alta (padrão superior a 60 KBps). |
| 0x04000000 (26) | Atribua apenas se o dispositivo estiver ancorado, isto é, está ligado a um ambiente de trabalho que está a utilizar o ActiveSync. |
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 os clientes. O valor padrão é 19900101000000.00000+****.
ExpirationTimeEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true se o anúncio expirar no momento indicado pela ExpirationTime propriedade. O valor predefinido é false.
ExpirationTimeIsGMT
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true se o tempo definido na ExpirationTime propriedade estiver em UMT. O valor predefinido é 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 às subcolições da coleção especificada.
ISVData
Tipo de dados: Matriz Uint8
Tipo de acesso: Leitura/Escrita
Eliminatórias: [grande, preguiçoso]
Informação que permite a um único ISV armazenar dados relativos a uma SMS_Program instância. Não existem restrições ou formatos definidos para estes dados. No entanto, é importante não substituir a propriedade após a sua propriedade ISV ter sido estabelecida. Portanto, o pedido de chamada deve ler primeiro os dados existentes nesta propriedade. Se os dados não pertencerem à aplicação, não deve ser modificado. Qualquer ISV ou proprietário de aplicações que esteja a usar 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: [em diferido]
O tamanho dos dados representados pela ISVData propriedade. O valor predefinido é 0.
ISVString
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: nenhuma
Corda para extensibilidade do parceiro.
MandatoryCountdown
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Qualificadores: Nenhum
Duração, em minutos, para mostrar a notificação obrigatória da notificação do sistema operativo. O valor predefinido é 0.
OfferType
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Eliminatórias: [enumeração]
Tipo de anúncio que indica que o anúncio é direcionado para os utilizadores.
| Valor | Descrição |
|---|---|
| 0 | Necessário |
| 2 | Disponível |
PackageID
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [Not_null]
ID para um pacote existente associado ao anúncio. O valor deve estar em maiúscula.
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 padrão é 19900101000000.00000+****.
PresentTimeEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true (predefinição) se o tempo presente for aplicado pelo Gestor de Configuração.
PresentTimeIsGMT
Tipo de dados: Boolean
Tipo de acesso: Leitura/Escrita
Qualificadores: [em diferido]
true se o tempo definido na PresentTime propriedade estiver em UMT. O valor predefinido é false.
Priority
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Eliminatórias: [enumeração]
A prioridade usada na replicação do anúncio em sites infantis. Os valores possíveis estão listados abaixo. O valor predefinido é NORMAL (2).
| Valor | Descrição |
|---|---|
| 1 | HIGH |
| 2 | NORMAL |
| 3 | LOW |
ProgramName
Tipo de dados: String
Tipo de acesso: Leitura/Escrita
Eliminatórias: [Not_null]
Um programa dentro do pacote especificado PackageID () a ser anunciado.
RemoteClientFlags
Tipo de dados: UInt32
Tipo de acesso: Leitura/Escrita
Qualificadores: [bits]
Bandeiras especificando 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.
| Hexadecimal (Bit) | Description |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Executar o programa utilizando a bateria. Este valor não é atualmente desuso. |
| 0x00000002 (1) | RUN_FROM_CD. Executar o programa a partir de CD. Este valor não é atualmente desuso. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Descarregue o programa a partir de CD. Este valor não é atualmente desuso. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Executar o programa a partir do ponto de distribuição local. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Descarregue o programa a partir do ponto de distribuição local. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Não executar o programa se não houver um ponto de distribuição local. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Descarregue o programa a partir do ponto de distribuição remota. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Executar o programa a partir do ponto de distribuição remota. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Descarregue o programa a pedido do ponto de distribuição local. Isto só é aplicável para sequências de tarefas. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Descarregue o programa a pedido a partir do ponto de distribuição remota. Isto só é aplicável para sequências de tarefas. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. São necessários lembretes de balão. |
| 0x00000800 (11) | RERUN_ALWAYS. Sempre reencando o programa. |
| 0x00001000 (12) | RERUN_NEVER. Nunca repita o programa. |
| 0x00002000 (13) | RERUN_IF_FAILED. Reencasse o programa se a execução anteriormente falhar. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Reencasse o programa se a execução tivesse sido bem sucedida anteriormente. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Esta informação aplica-se a System Center Gestor de Configuração SP1 ou posteriormente, e System Center Gestor de Configuração R2 de 2012 ou posterior. |
| 0x00020000 (17) | NÃO T_FALLBACK Esta informação aplica-se a System Center Gestor de Configuração SP1 ou posteriormente, e System Center Gestor de Configuração R2 de 2012 ou posterior. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Esta informação aplica-se a System Center Gestor de Configuração SP1 ou posteriormente, e System Center Gestor de Configuração R2 de 2012 ou posterior. |
SourceSite
Tipo de dados: String
Tipo de acesso: Só de leitura
Qualificadores: [leitura]
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
Eliminatórias: [ler, bits]
Reservado para uso interno. Bandeiras que duplicam a informação nas propriedades relacionadas com o tempo. Os valores possíveis estão listados abaixo. Por exemplo, ENABLE_PRESENT é definido quando PresentTimeEnabled é igual true .
| Hexadecimal (Bit) | Description |
|---|---|
| 0x00000001 (0) | ENABLE_PRESENT |
| 0x00000002 (1) | ENABLE_EXPIRATION |
| 0x00000004 (2) | ENABLE_AVAILABLE |
| 0x00000008 (3) | ENABLE_UNAVAILABLE |
| 0x00000010 (4) | ENABLE_MANDATORY |
| 0x00000020 (5) | GMT_PRESENT |
| 0x00000040 (6) | GMT_EXPIRATION |
| 0x00000080 (7) | GMT_AVAILABLE |
| 0x00000100 (8) | GMT_UNAVAILABLE |
| 0x00000200 (9) | GMT_MANDATORY |
Observações
Os qualificadores de classe desta classe incluem:
Protegido
Para obter mais informações sobre os qualificadores de classe e os qualificadores de propriedade incluídos na secção Propriedades, veja Classe e Qualificadores de Propriedade do Configuration Manager.
Embora não existam outras propriedades-chave, as propriedades
AdvertisementName, , , e sãoCollectionIDPackageIDProgramNamequalificadas como NOT_NULL, e os valores devem ser fornecidos. A sua aplicação não pode atualizar estas propriedades após a criação de uma instância de classe. Para alterar estes valores, a aplicação deve eliminar 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 Configuration Manager Server Runtime Requirements (Requisitos de Tempo de Execução do Servidor do Configuration Manager).
Requisitos de desenvolvimento
Para obter mais informações, consulte Configuration Manager Server Development Requirements (Requisitos de Desenvolvimento do Servidor do Configuration Manager).