Template status

To verify that a template is functioning as intended, you can examine its status in the main template list in the RAS Console (the Status column). When a template is functioning properly, the Status column displays "Ready", which means that guest VMs can be created from it as needed. When a template is being created or when it's in maintenance, or when it's being removed, the status will change accordingly.

Note that one of the other columns in the table is Agent status, which is the status of the RAS Guest Agent installed in a template. Compared to servers in the RAS infrastructure (Publishing Agent, Gateways, RD Session Hosts, etc), the agent status is not as important in a template as the template status. This is because a template is not a regular virtual machine and is not normally running, so checking the agent status in a stopped VM doesn't make much sense. This is why the agent status for a template in the RAS Console is usually Not Available, which is perfectly normal. The only situation when the Agent status displays a meaningful value is when the template is in Maintenance and running like a regular VM, in which case.the agent is also running an its status can be verified.

The tables below describe what the Status and Agent status columns will show for various template states or transitions.

Template creation

Status color	Template status	Agent status	Description
Gray	Not available	Not available	When a provider is disabled or VDI Agent is disconnected or the template does not exist.
Gray	Not applied	Not applied	Awaiting admin to click Apply in the RAS Console after the wizard completion.
Orange	Creating	Not available	When using Azure Gallery as a source (no pre-created host available).
Orange	Agent installation	Not available then OK	Deploying the agent to a newly created or available VM to be used as a template.
Orange	Deployment in progress	Optimization pending	When the optimization is waiting to be applied. The admin can stop the optimization at this point.
		Optimization in progress	When the optimization is in progress. The admin can still stop the optimization at this point.
		OK then Not available	Internal procedure when converting a VM to a template. Once the conversion is completed, the template status changes to "Ready".
Red	Creation failed	Not available	A problem has occurred. For example, a quota hit or a resource creation issue in Azure. The admin can retry the action by clicking Tasks > Retry last action.
Red	Agent installation failed	Not available	Possible network issues, file share limitations, or an issue with admin rights. The admin can try Tasks > Retry last action.
Red	Deployment failed	The actual status (OK, Not available, etc.)	A problem has occurred. For example, a quota hit, storage space, or snapshot creation from provider issue. The admin can try Tasks > Retry last action.
		FSLogix not available	FSLogix agent not found.
		FSLogix not updated	FSLogix agent needs updating.

Template in production

Status color	Template status	Agent status	Description
Green	Ready	The actual status (OK, Not available, etc.)	Template is ready.
Green	Cloning	The actual status (OK, Not available, etc.)	A guest VM is being cloned from the template.
Orange	Needs update	Needs update	RAS Guest Agent needs updating.

Template in maintenance

Status color	Template status	Agent status	Description
Orange	Maintenance	The actual status (OK, Not verified, etc.)	Guest VM used as the template is up and running,
		Optimization pending	When the optimization is waiting to be applied. The admin can stop the optimization at this point.
		Optimization in progress	When the optimization is in progress. The admin can still stop the optimization at this point.
		Needs update	Guest VM used as the template is up and running but RAS Guest Agent needs updating.

Template removal

Status color	Template status	Agent status	Description
Gray	Marked for deletion	The actual status while the guest VM used as the template is still running (OK, Not verified, etc.)	The template is in the process of being deleted.

Top of page