# AgentState.md ## NAME AgentState ## DESCRIPTION | Values | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | AutoUpgradeLimitReached | A host has reached the attempt limit for automatically upgrading the | | agent service. Host will need to be upgraded manually | AutoUpgradeFailed | | A host has failed to upgrade the agent service automatically | Unknown | | No agent state information available | NeedsUpdate | | Agent version is less than the RAS Server version | NotVerified | | Agent not connected to RAS Connection Broker and cannot be used | ServerDeleted | | Agent was removed from configuration | DisabledFromSettings | | Agent was disabled from configuration but it's still available in the | runtime. | | Disconnected | Disconnected. Agent is not connected to any RAS Connection Broker. | | OK | Agent is working correctly | | EnumSessionsFailed | Failed to get session information from the agent | | RDSRoleDisabled | RD Session Host disabled or denying connections | | MaxNonCompletedSessions | Maximum number of non-completed sessions limit reached | | RASScheduleInProgress | A Schedule is currently in progress. For more information check the | | property PendingSchedule. | ConnectionFailed | | Agent cannot connect to the host | InvalidCredentials | | Connection to host failed because of invalid credentials | NeedsSysprep | | Guest agent needs Sysprep answer file | SysPrepInProgress | | Sysprep in progress on machine | CloningFailed | | Cloning process failed | Synchronising | | Synchronizing agent settings is in progress | LogonDrainUntilRestart | | New logons disabled (drain mode) until restart | LogonDrain | | New logons disabled (drain mode) | LogonDisabled | | Logons and re-connections disabled | ForcedDisconnect | | Agent forced to disconnect | CloningCanceled | | Cloning canceled | RASprepInProgress | | RASprep in progress on machine | InstallingRDSRole | | Installing RDS role | RebootPending | | A server reboot is pending | PortMismatch | | Port mismatch | NeedsDowngrade | | Agent version is greater than the RAS Connection Broker version | NotApplied | | Agent settings not applied | CloningInProgress | | Cloning | MarkedForDeletion | | Agent is marked for deletion | StandBy | | Agent is in standby mode | UnsupportedVDIType | | Provider type is not supported | FreeESXLicenseNotSupported | | Free ESX License is not supported with RAS | ManagedESXNotSupported | | Managed ESX License is not supported by RAS | InvalidHostVersion | | Invalid Provider version | NotJoined | | Tenant is invited to join or has been added to the Farm but not yet | joined | | LicenseExpired | The Tenant License has expired. | | JoinBroken | Tenant's join is broken | | InUse | Agent is already connected to another farm | | NotInUse | Agent is not connected to any farm | | Unsupported | Agent version is no longer supported, or agent's OS is no longer | | supported | NoAvailableGateways | | There are no RAS Secure Gateways that the Tenant Broker can use to | process connections. | | EnrollServerNotInitialized | Enrollment agent not initialized (i.e. waiting for new settings) | | EnrollmentUnavailable | Enrollment agent certificate was not created | | InvalidCAConfig | Invalid Certificate Authority configuration | | InvalidEAUserCredentials | Invalid enrollment agent credentials | | InvalidESSettings | Invalid Enrollment Agent Settings | | FSLogixNotAvail | FSLogix is not available | | NoDevices | HALB Instance: No HALB devices are configured | | NeedsAttention | HALB Instance: One or more HALB devices are not configured, or AVD | | HostPool is empty (no hosts assigned) | ImageOptimizationPending | | Image optimization is in pending state | ImageOptimization | | Image optimization is in active state | Unavailable | | Agent is not available since depending objects are not available or | empty | | UnderConstruction | Agent under construction | | Broken | Agent broken state | | NonRAS | Non-RAS agent (AVD related agents) | | Provisioning | A clone is being provisioned from the assigned template | | Invalid | AVD object data corrupted | | FSLogixNeedsUpdate | Version of installed FSLogix older than the one in configuration | | NoMembersAvailable | No members in the host pool | | MembersNeedUpdate | One or more members in the host pool need to update state | | FailedPerfCounters | Performance counters failed to initialize | | PendingRecreation | Machine will be recreated on the last user logoff | | RemovingMembers | Guest being removed from the host pool | | ScalingIn | Deprecated: use RemovingMembers instead | | AddingMembers | Guest being added to the host pool | | ScalingOut | Deprecated: use AddingMembers instead | | DeleteInProgress | A delete is currently in progress | | RestrictedAddress | Restricted address | | JoiningToHostPool | A host is currently being joined to a host pool | | AutoUpgradeInProgress | A host is current performing an agent service upgrade automatically | | AutoUpgradeInitiated | A host or hostpool is in an auto-upgrade maintenance window | | ReplicaMigrationInProgress | Template replica for multi-provider distribution is migrating to a | | target host | AzureStateInstallGuestAgent | | Installing guest agent | ### References to Types | | | | | [AVDHostPoolStatus](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/AVDHostPoolStatus.md) | | | [AVDHostSysSessionApp](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/AVDHostSysSessionApp.md) | | | [BrokerSysInfo](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/BrokerSysInfo.md) | | | [GatewaySysInfo](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/GatewaySysInfo.md) | | | [HALBDeviceStatus](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/HALBDeviceStatus.md) | | | [JoinedBrokerStatus](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/JoinedBrokerStatus.md) | | | [ProviderHostApp](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/ProviderHostApp.md) | | | [ProviderSysInfoHost](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/ProviderSysInfoHost.md) | | | [RASAgentInfo](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/RASAgentInfo.md) | | | [RDSHostSysInfo](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/RDSHostSysInfo.md) | | | [RDSHostSysInfoSessionApp](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/RDSHostSysInfoSessionApp.md) | | | [TemplateStatus](https://github.com/Parallels-Corp/RAS-20-docs/blob/origin/admin-guide-20.3-release/20_RAS-20_API_Guides/PS-API/MD/RASAdmin/types/TemplateStatus.md) | | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/agentstate.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.