Scenario: The administrator wants to download the Get-DiskSpace.ps1 file on selected workstations.
Steps:
- Copy the Get-DiskSpace.ps1 file into the file location of the configured Custom Downloads Repository.
- On the Actions screen, click the New button under the Actions table.
-
Add a Custom Action named "Get-Diskspace". The Action Display Name is how the option will appear in the Actions menu. Select the "Computer" Action Target so the menu option will appear in the Actions menu on the Computer Actions screen.
- Click the New button under the Tasks table.
-
Select the "Download File" Task Type and enter the File Name. The full path to the file should not be entered.
-
Select the task, select "Get-Diskspace" from the Select Action drop-down menu and click the Add To button.
Ensure the Action is active. The action can be expanded to view the associated Task.
- On the Devices + Servers screen, select the devices and then select the new "Get Disk Space" option from the Actions menu. When the new download job is run successfully against a machine, the Get-DiskSpace.ps1 file will reside locally on disk at c:\Program Files (x86)\Binary Tree\P365ActiveDirectoryAgent\Downloads\.
What ports does the agent use to connect?
The Active Directory Agent uses three outbound ports
I’ve installed the agent and the device isn’t ready, what do I do?
On startup the Active Directory agent will phone home sometime in the first four hours. This communication offset time is an agent specific random and evenly distributed offset so the initial communications of a large number of devices set up at once will be spaced out and not overload the servers. If your device has the agent installed but you haven’t waited up to four hours yet, wait up to four hours and then re-check the Ready Devices list to see if your device shows up before proceeding to other network troubleshooting operations.
How do I adjust the agent polling interval?
In Active Directory, unlike in Active Directory Pro, the agent polling interval is not end user adjustable. The polling interval is every two minutes over UDP and every four hours over TCP. Should this amount of network traffic be an issue contact Support to investigate reducing the polling interval. Note that reducing the polling interval will cause queued migration actions to take longer to be picked up by the agents.
How many migration actions can I queue at once?
In Active Directory you can queue as many migration actions at once as you would like. There is a hard limit of 600 agents per each two minutes who will be notified by the job availability cache that they have a job waiting for them. Therefore the minimum amount of time which could be required for those queued migration actions to be picked up will be the number of queued migration actions divided by 600 and multiplied by two minutes.
Agent last contact time isn’t updating every two minutes is something wrong?
In Active Directory the Agent last contact time is updated based on the TCP connection with the back end. This will occur if a job is retrieved or every 4 hours as a fall back. It is not expected that the agent last contact time will update every two minutes even if the UDP requests to the job availability cache are functioning correctly.
The machine name was changed during the migration project, will it keep working?
Changing the machine name during a migration project may have unexpected implications. We recommend that you avoid doing so if possible. If not, you will need to delete the device from Power365 and reinstall the agent. Use the Status Resets action to reset the registration status of the device, then set the Directory Sync Workflow to reconcile on next run and run it. This will delete the old device from the database. Finally, reinstall the Active Directory Agent on that device and run the Workflow again to read it in.
How do I remove Devices from Active Directory?
To delete registered Devices from Active Directory, first use the Status Resets action to clear their registration status, then run the related Directory Sync Workflow with the setting ‘Reconcile on next run’ enabled. Any unregistered device records in scope of the Workflow will be removed from the database during a reconcile.
