Classe WMI do servidor SMS_Advertisement
A SMS_Advertisement classe WMI (Instrumentação de Gerenciamento do Windows) é uma classe de servidor provedor de SMS, em Configuration Manager, que representa um anúncio usado para anunciar programas de pacote de software que estão disponíveis para execução em clientes.
A sintaxe a seguir é simplificada do código MOF (Formato de Objeto Gerenciado) 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 na SMS_Advertisement classe.
| Método | Descrição |
|---|---|
| Método GetAdvertisements na classe SMS_Advertisement | Obtém as IDs de anúncio direcionadas ao 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 status de aviso sobre uma implantação de usuário para uma coleção 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: Esse método é preterido. |
Propriedades
ActionInProgress
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [leitura, enumeração]
A ação atual que está sendo executada no pacote por Configuration Manager. Os valores possíveis são:
| Valor | Descrição |
|---|---|
| 0 | NENHUM |
| 1 | UPDATE |
| 2 | Adicionar |
AdvertFlags
Tipo de dados: UInt32
Tipo de acesso: Leitura/Gravação
Qualificadores: [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.
| Hexadecimal (Bit) | Descrição |
|---|---|
| 0x00000020 (5) | IMEDIATA. Anuncie o anúncio ao usuário imediatamente. |
| 0x00000100 (8) | ONSYSTEMSTARTUP. Anuncie o anúncio ao usuário na inicialização do sistema. |
| 0x00000200 (9) | ONUSERLOGON. Anuncie o anúncio ao usuário no logon. |
| 0x00000400 (10) | ONUSERLOGOFF. Anuncie o anúncio ao usuário no logoff. |
| 0x00001000 (12) | OPTIONALPREDOWNLOAD. Se a arquitetura e a linguagem selecionadas corresponderem à do cliente, o conteúdo do pacote será baixado com antecedência |
| 0x00008000 (15) | WINDOWS_CE. O anúncio é para um cliente de dispositivo. |
| 0x00010000 (16) | ENABLE_PEER_CACHING. Essas informações se aplicam ao System Center 2012 Configuration Manager SP1 ou posterior e ao System Center 2012 R2 Configuration Manager ou posterior. |
| 0x00020000 (17) | DONOT_FALLBACK. Não volte para pontos de distribuição desprotegidos. |
| 0x00040000 (18) | ENABLE_TS_FROM_CD_AND_PXE. A sequência de tarefas está disponível para mídia removível e o ponto de serviço PXE (ambiente de execução de pré-inicialização). |
| 0x00080000 (19) | APTSINTRANETONLY. |
| 0x00100000 (20) | OVERRIDE_SERVICE_WINDOWS. Substitua janelas de manutenção ao anunciar o anúncio ao usuário. |
| 0x00200000 (21) | REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Reinicialize fora das janelas de manutenção. |
| 0x00400000 (22) | WAKE_ON_LAN_ENABLED. Anuncie o anúncio ao usuário com o Wake On LAN habilitado. |
| 0x00800000 (23) | SHOW_PROGRESS. Anuncie o anúncio ao usuário mostrando o progresso da sequência de tarefas. |
| 0x02000000 (25) | NO_DISPLAY. O usuário não deve executar programas independentemente da atribuição. |
| 0x04000000 (26) | ONSLOWNET. As atribuições são obrigatórias por meio de uma conexão de rede lenta. |
| 0x10000000 (28) | TARGETTOWINPE. Direcione essa implantação apenas para WinPE. |
| 0x20000000 (29) | HIDDENINWINPE. Direcione essa implantação apenas para WinPE, mas se esconda no WinPE. Ele só pode ser usado pela variável TS SMSTSPreferredAdvertID. |
Esses sinalizadores devem ser coordenados com os sinalizadores especificados na ProgramFlags propriedade do programa anunciado. Por exemplo, se você definir 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 SMS_Program Classe WMI do Servidor.
Definir IMMEDIATE, ONUSERLOGON ou ONUSERLOGOFF ou fornecer um AssignedSchedule valor torna o programa anunciado obrigatório. Um programa obrigatório é executado automaticamente após o cliente receber 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 for definido ou o programa tiver um AssignedSchedule valor.
Defina NO_DISPLAY quando você não quiser 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.
Defina ONSLOWNET quando as atribuições são obrigatórias em uma conexão de rede lenta, por exemplo, quando um computador se conecta usando um modem.
AdvertisementID
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [key, ResID(801), ResDLL("SMS_RSTT.dll")]
Chave gerada automaticamente exclusiva que identifica o anúncio. O valor padrão é "".
AdvertisementName
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [Not_null]
Nome exclusivo amigável para o anúncio.
AssignedSchedule
Tipo de dados: SMS_ScheduleToken Matriz
Tipo de acesso: Leitura/Gravação
Qualificadores: [máximo(15), preguiçoso]
SMS_ScheduleToken objetos da Classe WMI do Servidor indicando a hora em que o anúncio se torna obrigatório nos clientes.
AssignedScheduleEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: [preguiçoso]
true se o agendamento definido na AssignedSchedule propriedade estiver ativo. O valor padrão é false.
AssignedScheduleIsGMT
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: [preguiçoso]
true se o cronograma definido na AssignedSchedule propriedade estiver em Tempo de Métrica Universal (UMT). O valor padrão é false.
AssignmentID
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [leia]
ID da atribuição associada ao anúncio.
CollectionID
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [Not_null]
Coleção existente à qual o anúncio é direcionado.
Comment
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Descrição ou observação simples sobre o anúncio. O valor padrão é "".
DeviceFlags
Tipo de dados: UInt32
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Sinalizadores que descrevem o dispositivo. Os valores possíveis estão listados abaixo. O valor padrão é 0.
| Hexadecimal (Bit) | Descrição |
|---|---|
| 0x01000000 (24) | Sempre atribua programa ao cliente. |
| 0x02000000 (25) | Atribua somente se o dispositivo estiver conectado atualmente a uma conexão de largura de banda alta (padrão acima de 60 KBps). |
| 0x04000000 (26) | Atribua somente se o dispositivo estiver encaixado, ou seja, ele será anexado a uma área de trabalho que está usando o ActiveSync. |
ExpirationTime
Tipo de dados: DateTime
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Data e hora em que o anúncio não está mais disponível para clientes. O valor padrão é 1990010100000.000000+***.
ExpirationTimeEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
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/Gravação
Qualificadores: [preguiçoso]
true se o tempo definido na ExpirationTime propriedade estiver no UMT. O valor padrão é false.
HierarchyPath
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Reservado.
IncludeSubCollection
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
true (padrão) se o anúncio for anunciado para as subcolleções da coleção especificada.
ISVData
Tipo de dados: Uint8 Matriz
Tipo de acesso: Leitura/Gravação
Qualificadores: [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 tiver sido estabelecida. Portanto, o aplicativo de chamada deve ler os dados existentes nesta propriedade primeiro. Se os dados não pertencerem ao aplicativo, eles não deverão ser modificados. Qualquer ISV ou proprietário do 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
Qualificadores: [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
Qualificadores: nenhum
Cadeia de caracteres para extensibilidade de parceiro.
MandatoryCountdown
Tipo de dados: UInt32
Tipo de acesso: Leitura/Gravação
Qualificadores: Nenhum
Duração, em minutos, para mostrar a contagem regressiva obrigatória de agendamento 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.
| Valor | Descrição |
|---|---|
| 0 | Obrigatório |
| 2 | Disponível |
PackageID
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [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
Qualificadores: Nenhum
Data e hora em que o anúncio é disponibilizado aos clientes. O valor padrão é 1990010100000.000000+***.
PresentTimeEnabled
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: [preguiçoso]
true(padrão) se o tempo atual for imposto por Configuration Manager.
PresentTimeIsGMT
Tipo de dados: Boolean
Tipo de acesso: Leitura/Gravação
Qualificadores: [preguiçoso]
true se o tempo definido na PresentTime propriedade estiver no 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 em sites filho. Os valores possíveis estão listados abaixo. O valor padrão é NORMAL (2).
| Valor | Descrição |
|---|---|
| 1 | ALTA |
| 2 | NORMAL |
| 3 | Baixo |
ProgramName
Tipo de dados: String
Tipo de acesso: Leitura/Gravação
Qualificadores: [Not_null]
Um programa dentro do pacote especificado (PackageID) a ser anunciado.
RemoteClientFlags
Tipo de dados: UInt32
Tipo de acesso: Leitura/Gravação
Qualificadores: [bits]
Sinalizadores especificando 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.
| Hexadecimal (Bit) | Descrição |
|---|---|
| 0x00000001 (0) | BATTERY_POWER. Execute o programa usando a bateria. Atualmente, esse valor não é usado. |
| 0x00000002 (1) | RUN_FROM_CD. Execute o programa do CD. Atualmente, esse valor não é usado. |
| 0x00000004 (2) | DOWNLOAD_FROM_CD. Baixe o programa do CD. Atualmente, esse valor não é usado. |
| 0x00000008 (3) | RUN_FROM_LOCAL_DISPPOINT. Execute o programa do ponto de distribuição local. |
| 0x00000010 (4) | DOWNLOAD_FROM_LOCAL_DISPPOINT. Baixe o programa do ponto de distribuição local. |
| 0x00000020 (5) | DONT_RUN_NO_LOCAL_DISPPOINT. Não execute o programa se não houver nenhum ponto de distribuição local. |
| 0x00000040 (6) | DOWNLOAD_FROM_REMOTE_DISPPOINT. Baixe o programa do ponto de distribuição remota. |
| 0x00000080 (7) | RUN_FROM_REMOTE_DISPPOINT. Execute o programa do ponto de distribuição remota. |
| 0x00000100 (8) | DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Baixe o programa sob demanda do ponto de distribuição local. Isso só é aplicável para sequências de tarefas. |
| 0x00000200 (9) | DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Baixe o programa sob demanda do ponto de distribuição remota. Isso só é aplicável para sequências de tarefas. |
| x00000400 (10) | BALLOON_REMINDERS_REQUIRED. Lembretes de balão são necessários. |
| 0x00000800 (11) | RERUN_ALWAYS. Sempre execute novamente o programa. |
| 0x00001000 (12) | RERUN_NEVER. Nunca execute novamente o programa. |
| 0x00002000 (13) | RERUN_IF_FAILED. Execute novamente o programa se a execução tiver falhado anteriormente. |
| 0x00004000 (14) | RERUN_IF_SUCCEEDED. Execute novamente o programa se a execução tiver sido bem-sucedida anteriormente. |
| 0x00008000 (15) | PERSIST_ON_WRITE_FILTER_DEVICES Essas informações se aplicam ao System Center 2012 Configuration Manager SP1 ou posterior e ao System Center 2012 R2 Configuration Manager ou posterior. |
| 0x00020000 (17) | DON'T_FALLBACK Essas informações se aplicam ao System Center 2012 Configuration Manager SP1 ou posterior e ao System Center 2012 R2 Configuration Manager ou posterior. |
| 0x00040000 (18) | DP_ALLOW_METERED_NETWORK Essas informações se aplicam ao System Center 2012 Configuration Manager SP1 ou posterior e ao System Center 2012 R2 Configuration Manager ou posterior. |
SourceSite
Tipo de dados: String
Tipo de acesso: somente leitura
Qualificadores: [leia]
Código do site de três letras do site de origem do anúncio.
TimeFlags
Tipo de dados: UInt32
Tipo de acesso: somente leitura
Qualificadores: [leitura, 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 .
| Hexadecimal (Bit) | Descrição |
|---|---|
| 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 |
Comentários
As qualificatórias de classe para esta classe incluem:
Protegido
Para obter mais informações sobre as qualificatórias de classe e as qualificatórias de propriedade incluídas na seção Propriedades, consulte Configuration Manager Qualificadores de Classe e Propriedade.
Embora não haja outras propriedades principais, as propriedades
AdvertisementName,CollectionID,PackageIDeProgramNamesã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 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.
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