Microsoft MECM - Add or Remove Assets to/from Collection (PS-based)

Microsoft MECM - Add or Remove Assets to/from Collection (PS-based) adds devices to or removes them from a collection using direct membership rules for:

• Assets returned by the selected query or assets selected on the relevant asset page.

💡

Note

This Enforcement Action replaces Microsoft MECM - Add or Remove Assets to Collection, as it uses PowerShell commands, which is the Microsoft-recommended method of adding devices to a collection.Microsoft MECM - Add or Remove Assets to Collection is still supported, but this action is recommended.

Required Fields

These fields must be configured to run the Enforcement Set.

• Host - The hostname or IP address of the host that has Configuration Manager cmdlets available to run via PowerShell.
• Username - A username with the required permissions to run this action.
• Password - The user's password..
• EC Action - Select between Add to Collection and Remove from Collection.
• Site Code - The Configuration Manager site code in which the Enforcement Action will run.
• Collection Name - The name of the collection to which the changes will apply.

• Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

Additional Fields

These fields are optional.

• Site Server - The SCCM server hostname. When this field is provided, the Enforcement Action assumes that double-hop will occur. In this scenario, the Axonius system connects to the device configured in the Host and then to the SCCM server configured in the Site Server field. When this field is empty, the Enforcement Action assumes that a connection will be made directly to the SCCM server, and so the Host field is parsed as the SCCM server h ostname.
  • Example 1: The Host field value is proxy_server.com and the Site Server field value is SCCM_server.com. In this case, The Enforcement Action will connect to proxy_server.com and from this device it will connect to SCCM_server.com.
  • Example 1: The Host field value is SCCM_server.com and the Site Server field value is empty. In this case, The Enforcement Action will connect directly to SCCM_server.com.

• Gateway Name - Select the Gateway through which to connect to perform the action.

APIs

Axonius uses the ConfigurationManager API.

Required Ports

Axonius must be able to communicate via the following ports:

• 5986

Required Permissions

The stored credentials must have permission to run the following cmdlets in PowerShell:

• Add-CMDeviceCollectionDirectMembershipRule
• Get-CMDevice
• Get-CMDeviceCollection
• Remove-CMDeviceCollectionDirectMembershipRule
• Import-Module
• Set-Location

---