Skip to main content

1E 8.1 (on-premises)

Nomad.RunSsdQuery

Method

RunSsdQuery

Module

Nomad

Library

1E

Action

Use Nomad's SSD (single site download) feature to find on which devices the specified content is cached.

Parameters

ContentId (string): The ID of the content to query.

Version (int): The version of the content to query.

Format (int; optional, default 0): How the content is stored in the cache. 0 = original Nomad format (neither compressed nor encrypted), 1 = compressed, 2 = compressed and encrypted.

Percent (float): The minimum desired percentage of content in the cache.

Extent (int): Whether to search the entire site (0) or just the local subnet (1).

MaxDevices (int): The maximum number of devices to return. The range is 1 to 50.

AllSubnets (bool): Whether to return results with a good distribution of subnets (true) or allow it does not matter if the devices are clustered in a few subnets or even just one (false).

Return values

For each suitable device (and there may be none):

Fqdn (string): The fully qualified domain name of the device.

Ipv4 (string): The IPv4 address of the device.

Ipv4Subnet (string): The IPv4 subnet of the device.

Example

Find up to 10 devices that have at least 50% of (ConfigMgr) content "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c" version 1, neither compressed nor encrypted. Try to return devices from a number of subnets.

Nomad.RunSsdQuery(ContentId : "Content_7f368e5f-4dbe-4027-ba81-c5463e372a0c", Version : 1, Format : 0, Percent : 50.0, Extent: 0, MaxDevices : 10, AllSubnets : true);

Platforms

  • Windows

Notes

Nomad SSD must be enabled of course.

IPv6 addresses are not supported.