Share via


MSFT_SIPDeviceUpdaterRules (New)

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Contains rules for upgrading devices with a particular update. An instance of this class is created for each update. Organizations use Device Update Service to keep your Office Communications Server 2007 R2 Communicator devices up-to-date.

MSFT_SIPDeviceUpdaterRules

The property values for the MSFT_SIPDeviceUpdaterRules map to the columns found on the Pending Updates and Deployed Updates tabs of the Device Update Service management console. You can access these values in the Office Communications Server 2007 R2 Administration Tool by right-clicking an Enterprise pool or a Standard Edition server name, and then clicking Device Updater.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class MSFT_SIPDeviceUpdaterRules
{
  string ApprovedVersion;
  [key] string Backend;
  string Brand;
  string DeviceType;
  [key] string InstanceID;
  string Locale;
  string Model;
  string PendingVersion;
  string Revision;
  string RollbackVersion;
  string UpdateType;
  string Vendor;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPDeviceUpdaterRules class has the following properties.

  • ApprovedVersion
    Data type: string

    Access type: Read/Write

    Optional. Approved device update version for the {Device Type x Brand x Model x Revision x Locale} combination. Maps to the Approved column in the Device Update Service management console.

    The maximum length of the string is 20 characters.

  • Backend
    Data type: [key] string

    Access type: Read-only

    Required: When accessing data from any role that belongs to a pool. This property must be empty when accessing data from the Edge Server or Proxy Server role. The Backend value does not appear in the Administration Tool.

    This property identifies the instance of SQL Server that manages the back-end database for Office Communications Server.

    The value for this property depends on the topology of Office Communications Server.

    Topology

    Value

    Standard Edition

    (local)\rtc

    Enterprise Edition

    (consolidated or expanded configuration)

    computername\instancename

    or

    computername

    For Enterprise Edition, computername identifies either the FQDN or the NetBIOS name of the host computer for SQL Server and instancename identifies a named instance of SQL Server on the host computer. The value computername by itself specifies the default instance of SQL Server on the host computer.

  • Brand
    Data type: string

    Access type: Read/Write

    Required. The brand of the device. Maps to the Brand column in the Device Update Service management console.

    The maximum length of the string is 260 characters.

  • DeviceType
    Data type: string

    Access type: Read/Write

    Required. The type of device targeted by the update. Maps to the Device Type column in the Device Update Service management console.

    The following values are supported.

    Type

    Description

    Roundtable

    Microsoft RoundTable conferencing device

    UCPhone

    Microsoft Communicator 2007 R2 Phone Edition

    The maximum length of the string is 260 characters.

  • InstanceID
    Data type: [key] string

    Access type: Read-only

    Required. A GUID value that uniquely identifies an instance of this class. The InstanceID value does not appear in the Administration Tool.

    The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".

  • Locale
    Data type: string

    Access type: Read/Write

    Required. The locale ID that specifies the language version for the device update. Maps to the Locale column in the Device Update Service management console.

    The maximum length of the string is 5 characters.

  • Model
    Data type: string

    Access type: Read/Write

    Required. The model of the device. Maps to the Model column in the Device Update Service management console.

    The maximum length of the string is 260 characters.

  • PendingVersion
    Data type: string

    Access type: Read/Write

    Optional. The pending device update version for the {Device Type x Brand x Model x Revision x Locale} combination. Maps to the Pending column on the Pending Updates tab in the Device Update Service management console.

    The maximum length of the string is 20 characters.

  • Revision
    Data type: string

    Access type: Read/Write

    Required. The revision of the device. Maps to the Revision column in the Device Update Service management console.

    The maximum length of the string is 260 characters.

  • RollbackVersion
    Data type: string

    Access type: Read/Write

    Optional. The rollback device update version for the {Device Type x Brand x Model x Revision x Locale} combination. Maps to the Roll Back column in the Device Update Service management console.

    The maximum length of the string is 20 characters.

  • UpdateType
    Data type: string

    Access type: Read/Write

    Required. Maps to the Update Type column in the Device Update Service management console.

  • Vendor
    Data type: string

    Access type: Read/Write

    Required. The vendor of the device. The Vendor value does not appear in the Administration Tool.

    The value of this property is not case-sensitive.

Remarks

This class gets and sets information at the following level: SQL.

Instances of this class support the following interface methods:

  • Provider::DeleteInstance();

  • Provider::GetObject();

  • Provider::PutInstance();

    Where PutInstance() supports the following flags:

    • WBEM_FLAG_CREATE_ONLY

    • WBEM_FLAG_UPDATE_ONLY

    • WBEM_FLAG_CREATE_OR_UPDATE

Requirements

Server: Installed on computers serving the following roles: Administrative Tools Server and Front End Server.

Namespace: Defined in \root\cimv2.

See Also

Concepts

Office Communications Server WMI Reference

Other Resources

Managing Device Updates