Contents

Nomad.RunSsdQuery

Method

RunSsdQuery

ModuleNomad
Library1E
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.