다음을 통해 공유

SMS_Advertisement 서버 WMI 클래스

  • 아티클

SMS_Advertisement WMI(Windows Management Instrumentation) 클래스는 Configuration Manager SMS 공급자 서버 클래스로, 클라이언트에서 실행할 수 있는 소프트웨어 패키지 프로그램을 알리는 데 사용되는 광고를 나타냅니다.

다음 구문은 MOF(Managed Object Format) 코드에서 간소화되며 상속된 모든 속성을 포함합니다.

구문

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;  
};

메서드

다음 표에서는 클래스의 메서드를 나열합니다 SMS_Advertisement .

방법 설명
클래스 SMS_Advertisement GetAdvertisements 메서드 리소스를 대상으로 하는 보급 알림 ID를 가져옵니다.
클래스 SMS_Advertisement GetNextID 메서드 만든 다음 보급 알림에 사용할 ID 번호를 검색합니다.
클래스 SMS_Advertisement RiskyDeploymentStatusMessage 메서드 위험한 컬렉션에 사용자 배포에 대한 경고 상태 메시지를 보냅니다.
클래스 SMS_Advertisement SetNextID 메서드 만든 다음 보급 알림에 사용할 ID 번호를 설정합니다.
클래스 SMS_Advertisement SetSourceSite 메서드 보급 알림의 소스 사이트 코드를 설정합니다.
클래스 SMS_Advertisement Unlock 메서드 원본 사이트를 현재 사이트로 설정하여 보급 알림을 잠금 해제합니다. 경고: 이 메서드는 더 이상 사용되지 않습니다.

속성

ActionInProgress

데이터 형식: UInt32

액세스 유형: 읽기 전용

한정자: [읽기, 열거형]

Configuration Manager 패키지에서 수행 중인 현재 작업입니다. 가능한 값은 다음과 같습니다.

값 설명
0 없음
1 업데이트
2 추가

AdvertFlags

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [비트]

알림을 사용자에게 알리는 방법을 나타내는 플래그입니다. 가능한 값은 다음과 같습니다. 기본값은 0입니다.

16진수(비트) 설명
0x00000020 (5) 즉각적인. 사용자에게 즉시 알림을 알려 하세요.
0x00000100 (8) ONSYSTEMSTARTUP. 시스템 시작 시 사용자에게 알림을 알려 하세요.
0x00000200 (9) ONUSERLOGON. 로그온할 때 사용자에게 광고를 알리기.
0x00000400 (10) ONUSERLOGOFF. 로그오프 시 사용자에게 알림을 알리기.
0x00001000 (12) OPTIONALPREDOWNLOAD. 선택한 아키텍처 및 언어가 클라이언트의 아키텍처와 일치하는 경우 패키지 콘텐츠가 미리 다운로드됩니다.
0x00008000 (15) WINDOWS_CE. 보급 알림은 디바이스 클라이언트용입니다.
0x00010000 (16) ENABLE_PEER_CACHING. 이 정보는 System Center 2012 Configuration Manager SP1 이상 및 System Center 2012 R2 Configuration Manager 이상에 적용됩니다.
0x00020000 (17) DONOT_FALLBACK. 보호되지 않은 배포 지점으로 대체하지 마세요.
0x00040000 (18) ENABLE_TS_FROM_CD_AND_PXE. 작업 순서는 이동식 미디어 및 PXE(사전 부팅 실행 환경) 서비스 지점에서 사용할 수 있습니다.
0x00080000 (19) APTSINTRANETONLY.
0x00100000 (20) OVERRIDE_SERVICE_WINDOWS. 사용자에게 보급 알림을 알리는 유지 관리 기간을 재정의합니다.
0x00200000 (21) REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. 유지 관리 기간 외부에서 다시 부팅합니다.
0x00400000 (22) WAKE_ON_LAN_ENABLED. Wake On LAN을 사용하도록 설정된 사용자에게 알림을 알려 줍니다.
0x00800000 (23) SHOW_PROGRESS. 작업 순서 진행률을 표시하는 사용자에게 알림을 표시합니다.
0x02000000 (25) NO_DISPLAY. 사용자는 할당과 독립적으로 프로그램을 실행해서는 안 됩니다.
0x04000000 (26) ONSLOWNET. 할당은 느린 네트워크 연결을 통해 필수입니다.
0x10000000 (28) TARGETTOWINPE. 이 배포를 WinPE로만 대상으로 지정합니다.
0x20000000 (29) HIDDENINWINPE. WinPE에만 이 배포를 대상으로 하지만 WinPE에서 숨깁니다. TS 변수 SMSTSPreferredAdvertID에서만 사용할 수 있습니다.

이러한 플래그는 보급된 프로그램의 속성에 ProgramFlags 지정된 플래그와 조정되어야 합니다. 예를 들어 ONUSERLOGOFF를 설정하는 경우 프로그램의 NOUSERLOGGEDIN 플래그를 설정해야 합니다. 플래그 설정이 일치하지 않으면 프로그램이 보급되지 않습니다. 자세한 내용은 SMS_Program 서버 WMI 클래스를 참조하세요.

IMMEDIATE, ONUSERLOGON 또는 ONUSERLOGOFF를 설정하거나 값을 제공 AssignedSchedule 하면 보급된 프로그램이 필수입니다. 필수 프로그램은 클라이언트가 광고를 받은 후 자동으로 실행됩니다. 클라이언트는 설치를 거부하거나 연기할 수 없습니다.

IMMEDIATE, ONUSERLOGON 또는 ONUSERLOGOFF 비트가 설정되거나 프로그램에 AssignedSchedule 값이 있는 경우에만 NO_DISPLAY 및 ONSLOWNET 비트를 설정합니다.

사용자가 할당과 독립적으로 프로그램을 실행하지 않도록 하려면 NO_DISPLAY 설정합니다. 이 플래그를 설정하지 않으면 보급 알림이 광고 목록에 표시되며 할당과 독립적으로 실행할 수 있습니다. 프로그램은 여전히 필수일 수 있습니다.

컴퓨터가 모뎀을 사용하여 연결하는 경우와 같이 느린 네트워크 연결을 통해 할당이 필수인 경우 ONSLOWNET을 설정합니다.

AdvertisementID

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [key, ResID(801), ResDLL("SMS_RSTT.dll")]

광고를 식별하는 고유한 자동 생성 키입니다. 기본값은 ""입니다.

AdvertisementName

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [Not_null]

광고에 대한 고유한 사용자 친화적인 이름입니다.

AssignedSchedule
데이터 형식: SMS_ScheduleToken 배열

액세스 유형: 읽기/쓰기

한정자: [max(15), 지연]

SMS_ScheduleToken 클라이언트에서 보급 알림이 필수가 되는 시간을 나타내는 서버 WMI 클래스 개체입니다.

AssignedScheduleEnabled

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true 속성에 정의된 일정이 AssignedSchedule 활성 상태이면 입니다. 기본값은 false입니다.

AssignedScheduleIsGMT

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true 속성에 정의된 일정이 AssignedSchedule UMT(유니버설 메트릭 시간)에 있으면 입니다. 기본값은 false입니다.

AssignmentID

데이터 형식: UInt32

액세스 유형: 읽기 전용

한정자: [읽기]

광고와 연결된 할당의 ID입니다.

CollectionID

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [Not_null]

보급 알림의 대상이 되는 기존 컬렉션입니다.

Comment

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

광고에 대한 간단한 설명 또는 참고 사항입니다. 기본값은 ""입니다.

DeviceFlags

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: 없음

디바이스를 설명하는 플래그입니다. 가능한 값은 다음과 같습니다. 기본값은 0입니다.

16진수(비트) 설명
0x01000000 (24) 항상 클라이언트에 프로그램을 할당합니다.
0x02000000 (25) 디바이스가 현재 높은 대역폭 연결에 연결된 경우에만 할당합니다(기본값은 60KBps 이상).
0x04000000 (26) 디바이스가 도킹된 경우에만 할당합니다. 즉, ActiveSync를 사용하는 데스크톱에 연결되어 있습니다.

ExpirationTime

데이터 형식: DateTime

액세스 유형: 읽기/쓰기

한정자: 없음

클라이언트에서 광고를 더 이상 사용할 수 없는 날짜 및 시간입니다. 기본값은 19900101000000.000000+****입니다.

ExpirationTimeEnabled

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true 속성으로 표시된 시간에 보급 알림이 만료되면 입니다 ExpirationTime . 기본값은 false입니다.

ExpirationTimeIsGMT

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true 속성에 정의된 ExpirationTime 시간이 UMT에 있으면 입니다. 기본값은 false입니다.

HierarchyPath

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

예약.

IncludeSubCollection

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: 없음

true (기본값) 보급 알림이 지정된 컬렉션의 하위 컬렉션에 보급되는 경우입니다.

ISVData

데이터 형식: Uint8 배열

액세스 유형: 읽기/쓰기

한정자: [large, lazy]

단일 ISV가 인스턴스와 관련된 데이터를 저장할 수 있도록 하는 정보입니다 SMS_Program . 이 데이터에 대한 제한 또는 정의된 형식은 없습니다. 그러나 ISV 소유권이 설정된 후에는 속성을 덮어쓰지 않는 것이 중요합니다. 따라서 호출 애플리케이션이 먼저이 속성의 기존 데이터를 읽어야 합니다. 데이터가 애플리케이션에 속하지 않는 경우 수정해서는 안 됩니다. 이 속성을 사용하는 모든 ISV 또는 애플리케이션 소유자는 소유권을 쉽게 설정할 수 있도록 데이터에 식별자를 포함해야 합니다.

ISVDataSize

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [지연]

속성이 나타내는 데이터의 크기입니다 ISVData . 기본값은 0입니다.

ISVString

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: 없음

파트너 확장성을 위한 문자열입니다.

MandatoryCountdown

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: 없음

운영 체제 배포 사용자 알림 필수 일정 카운트다운을 표시하는 기간(분)입니다. 기본값은 0입니다.

OfferType

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [열거형]

광고가 사용자를 대상으로 했음을 나타내는 광고 유형입니다.

값 설명
0 필수
2 사용 가능

PackageID

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [Not_null]

광고와 연결된 기존 패키지의 ID입니다. 값은 대문자여야 합니다.

PresentTime

데이터 형식: DateTime

액세스 유형: 읽기/쓰기

한정자: 없음

클라이언트에서 광고를 사용할 수 있게 된 날짜 및 시간입니다. 기본값은 19900101000000.000000+****입니다.

PresentTimeEnabled

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true(기본값) 현재 시간이 Configuration Manager 의해 적용되는 경우.

PresentTimeIsGMT

데이터 형식: Boolean

액세스 유형: 읽기/쓰기

한정자: [지연]

true 속성에 정의된 PresentTime 시간이 UMT에 있으면 입니다. 기본값은 false입니다.

Priority

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [열거형]

자식 사이트에 광고를 복제하는 데 사용되는 우선 순위입니다. 가능한 값은 다음과 같습니다. 기본값은 NORMAL(2)입니다.

값 설명
1 높은
2 정상적인
3 낮은

ProgramName

데이터 형식: String

액세스 유형: 읽기/쓰기

한정자: [Not_null]

보급할 지정된 패키지(PackageID) 내의 프로그램입니다.

RemoteClientFlags

데이터 형식: UInt32

액세스 유형: 읽기/쓰기

한정자: [비트]

클라이언트를 로컬로 또는 원격으로 배포 지점에 연결할 때 프로그램을 실행하는 방법을 지정하는 플래그입니다. 가능한 값은 다음과 같습니다. 기본값은 48입니다.

16진수(비트) 설명
0x00000001 (0) BATTERY_POWER. 배터리 전원을 사용하여 프로그램을 실행합니다. 이 값은 현재 사용되지 않습니다.
0x00000002 (1) RUN_FROM_CD. CD에서 프로그램을 실행합니다. 이 값은 현재 사용되지 않습니다.
0x00000004 (2) DOWNLOAD_FROM_CD. CD에서 프로그램을 다운로드합니다. 이 값은 현재 사용되지 않습니다.
0x00000008 (3) RUN_FROM_LOCAL_DISPPOINT. 로컬 배포 지점에서 프로그램을 실행합니다.
0x00000010 (4) DOWNLOAD_FROM_LOCAL_DISPPOINT. 로컬 배포 지점에서 프로그램을 다운로드합니다.
0x00000020 (5) DONT_RUN_NO_LOCAL_DISPPOINT. 로컬 배포 지점이 없는 경우 프로그램을 실행하지 마세요.
0x00000040 (6) DOWNLOAD_FROM_REMOTE_DISPPOINT. 원격 배포 지점에서 프로그램을 다운로드합니다.
0x00000080 (7) RUN_FROM_REMOTE_DISPPOINT. 원격 배포 지점에서 프로그램을 실행합니다.
0x00000100 (8) DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. 로컬 배포 지점에서 요청 시 프로그램을 다운로드합니다. 이는 작업 순서에만 적용됩니다.
0x00000200 (9) DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. 원격 배포 지점에서 요청 시 프로그램을 다운로드합니다. 이는 작업 순서에만 적용됩니다.
x00000400(10) BALLOON_REMINDERS_REQUIRED. 풍선 미리 알림이 필요합니다.
0x00000800 (11) RERUN_ALWAYS. 항상 프로그램을 다시 실행합니다.
0x00001000 (12) RERUN_NEVER. 프로그램을 다시 실행하지 마세요.
0x00002000 (13) RERUN_IF_FAILED. 이전에 실행하지 못한 경우 프로그램을 다시 실행합니다.
0x00004000 (14) RERUN_IF_SUCCEEDED. 이전에 실행이 성공한 경우 프로그램을 다시 실행합니다.
0x00008000 (15) PERSIST_ON_WRITE_FILTER_DEVICES

이 정보는 System Center 2012 Configuration Manager SP1 이상 및 System Center 2012 R2 Configuration Manager 이상에 적용됩니다.
0x00020000 (17) DON'T_FALLBACK

이 정보는 System Center 2012 Configuration Manager SP1 이상 및 System Center 2012 R2 Configuration Manager 이상에 적용됩니다.
0x00040000 (18) DP_ALLOW_METERED_NETWORK

이 정보는 System Center 2012 Configuration Manager SP1 이상 및 System Center 2012 R2 Configuration Manager 이상에 적용됩니다.

SourceSite

데이터 형식: String

액세스 유형: 읽기 전용

한정자: [읽기]

광고가 시작되는 사이트의 세 글자 사이트 코드입니다.

TimeFlags

데이터 형식: UInt32

액세스 유형: 읽기 전용

한정자: [읽기, 비트]

내부용으로 예약되어 있습니다. 시간 관련 속성의 정보를 복제하는 플래그입니다. 가능한 값은 다음과 같습니다. 예를 들어 ENABLE_PRESENT 가 와 같을 때 PresentTimeEnabled 설정됩니다.true

16진수(비트) 설명
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

설명

이 클래스의 클래스 한정자는 다음과 같습니다.

  • 보안됨

    속성 섹션에 포함된 클래스 한정자와 속성 한정자 모두에 대한 자세한 내용은 Configuration Manager 클래스 및 속성 한정자를 참조하세요.

    다른 키 속성은 없지만 , , CollectionID및 PackageIDProgramName 속성AdvertisementName은 NOT_NULL 한정되며 값을 제공해야 합니다. 클래스 인스턴스를 만든 후에는 애플리케이션에서 이러한 속성을 업데이트할 수 없습니다. 이러한 값을 변경하려면 애플리케이션에서 인스턴스를 삭제하고 올바른 값으로 새 인스턴스를 만들어야 합니다.

요구 사항

런타임 요구 사항

자세한 내용은 Configuration Manager 서버 런타임 요구 사항을 참조하세요.

개발 요구 사항

자세한 내용은 Configuration Manager 서버 개발 요구 사항을 참조하세요.