Contents

Method

TestConnection

ModulePatch
LibraryCore
Action

Check that the source for patches is accessible.

Parameters

Source (string; optional; default is to deduce the source): The source of patch meta-data, typically the installation mechanism used to handle the patch(es). One of:

  • CAB: A file with a .cab extension and appropriate binary structure containing update metadata, located somewhere in the file system available to the local agent. The file is used directly by the local Windows Update agent, without SCCM or WSUS being involved.
  • SCCM: System Center Configuration Manager.
  • WSUSL: A local (to the enterprise) corporate Windows Server Update Service server.
  • WSUSR: The remote Windows Server Update Service feed over the internet at microsoft.com .

Case is not significant.

If this parameter is not specified, the Tachyon Agent attempts to deduce the source as follows:

  1. If a CAB-file is specified and exists (although is not necessarily valid), the source is implicitly ' CAB '.
  2. Else if the SCCM client is enabled for software updates, the source is implicitly ' SCCM '.
  3. Else if a local Windows Software Update server is configured, the source is implicitly ' WSUSL '.
  4. Else if the remote Windows Software Update Service is configured, the source is implicitly ' WSUSR '.
  5. Else the source is unknown and must be specified explicitly; this causes an error.

When testing a WSUSL connection, this method includes a built-in random stagger interval so that multiple Tachyon Agents do not overwhelm the local WSUS server simultaneously.

CabFilePath (string; default empty): The full path of the location of the .cab file if Source is 'CAB'.

This must be specified if Source is 'CAB' and should not be specified for any other Source value.

If the path is specified it must be to a local CAB-file. Shared, i.e. remote, CAB-files are not supported by Windows Update Agent.

Only the existence of the CAB-file is checked; the contents are NOT validated.
Return values

ConnectionOk (boolean): Whether the Source can be accessed or not.

Source (string): Where the updates come from. One of:

  • CAB: A file with a .cab extension and appropriate binary structure containing update metadata, located somewhere in the file system available to the local agent. The file is used directly by the local Windows Update agent, without SCCM or WSUS being involved.
  • SCCM: System Center Configuration Manager.
  • WSUSL: A local (to the enterprise) corporate Windows Server Update Service server.
  • WSUSR: The remote Windows Server Update Service feed over the internet at microsoft.com .

This is useful if the source is not specified as an input parameter and has to be deduced.

SourceId (string): The identity of the source of updates. E.g. for a 'SCCM' source the site ID, or for WSUS the URL.

Example
@ConfigMgrOk = Patch.TestConnection(Source: "SCCM")
Platforms
  • Windows
Notes