We recommend using Azure Native.
azure.desktopvirtualization.getHostPool
Explore with Pulumi AI
Use this data source to access information about an existing Virtual Desktop Host Pool.
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
var example = Azure.DesktopVirtualization.GetHostPool.Invoke(new()
{
Name = "example-pool",
ResourceGroupName = "example-resources",
});
});
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/desktopvirtualization"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := desktopvirtualization.LookupHostPool(ctx, &desktopvirtualization.LookupHostPoolArgs{
Name: "example-pool",
ResourceGroupName: "example-resources",
}, nil)
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.desktopvirtualization.DesktopvirtualizationFunctions;
import com.pulumi.azure.desktopvirtualization.inputs.GetHostPoolArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var example = DesktopvirtualizationFunctions.getHostPool(GetHostPoolArgs.builder()
.name("example-pool")
.resourceGroupName("example-resources")
.build());
}
}
import pulumi
import pulumi_azure as azure
example = azure.desktopvirtualization.get_host_pool(name="example-pool",
resource_group_name="example-resources")
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = azure.desktopvirtualization.getHostPool({
name: "example-pool",
resourceGroupName: "example-resources",
});
variables:
example:
fn::invoke:
Function: azure:desktopvirtualization:getHostPool
Arguments:
name: example-pool
resourceGroupName: example-resources
Using getHostPool
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getHostPool(args: GetHostPoolArgs, opts?: InvokeOptions): Promise<GetHostPoolResult>
function getHostPoolOutput(args: GetHostPoolOutputArgs, opts?: InvokeOptions): Output<GetHostPoolResult>
def get_host_pool(name: Optional[str] = None,
resource_group_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetHostPoolResult
def get_host_pool_output(name: Optional[pulumi.Input[str]] = None,
resource_group_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetHostPoolResult]
func LookupHostPool(ctx *Context, args *LookupHostPoolArgs, opts ...InvokeOption) (*LookupHostPoolResult, error)
func LookupHostPoolOutput(ctx *Context, args *LookupHostPoolOutputArgs, opts ...InvokeOption) LookupHostPoolResultOutput
> Note: This function is named LookupHostPool
in the Go SDK.
public static class GetHostPool
{
public static Task<GetHostPoolResult> InvokeAsync(GetHostPoolArgs args, InvokeOptions? opts = null)
public static Output<GetHostPoolResult> Invoke(GetHostPoolInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetHostPoolResult> getHostPool(GetHostPoolArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: azure:desktopvirtualization/getHostPool:getHostPool
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
The name of the Virtual Desktop Host Pool to retrieve.
- Resource
Group stringName The name of the resource group where the Virtual Desktop Host Pool exists.
- Name string
The name of the Virtual Desktop Host Pool to retrieve.
- Resource
Group stringName The name of the resource group where the Virtual Desktop Host Pool exists.
- name String
The name of the Virtual Desktop Host Pool to retrieve.
- resource
Group StringName The name of the resource group where the Virtual Desktop Host Pool exists.
- name string
The name of the Virtual Desktop Host Pool to retrieve.
- resource
Group stringName The name of the resource group where the Virtual Desktop Host Pool exists.
- name str
The name of the Virtual Desktop Host Pool to retrieve.
- resource_
group_ strname The name of the resource group where the Virtual Desktop Host Pool exists.
- name String
The name of the Virtual Desktop Host Pool to retrieve.
- resource
Group StringName The name of the resource group where the Virtual Desktop Host Pool exists.
getHostPool Result
The following output properties are available:
- Custom
Rdp stringProperties The custom RDP properties string for the Virtual Desktop Host Pool.
- Description string
The description for the Virtual Desktop Host Pool.
- Friendly
Name string The friendly name for the Virtual Desktop Host Pool.
- Id string
The provider-assigned unique ID for this managed resource.
- Load
Balancer stringType The type of load balancing performed by the Host Pool
- Location string
The location/region where the Virtual Desktop Host Pool is located.
- Maximum
Sessions intAllowed The maximum number of users that can have concurrent sessions on a session host.
- Name string
- Personal
Desktop stringAssignment Type The type of personal desktop assignment in use by the Host Pool
- Preferred
App stringGroup Type The preferred Application Group type for the Virtual Desktop Host Pool.
- Resource
Group stringName - Scheduled
Agent List<GetUpdates Host Pool Scheduled Agent Update> A
scheduled_agent_updates
block as defined below.- Start
Vm boolOn Connect Returns
true
if the Start VM on Connection Feature is enabled.- Dictionary<string, string>
A mapping of tags to assign to the resource.
- Type string
The type of the Virtual Desktop Host Pool.
- Validate
Environment bool Returns
true
if the Host Pool is in Validation mode.
- Custom
Rdp stringProperties The custom RDP properties string for the Virtual Desktop Host Pool.
- Description string
The description for the Virtual Desktop Host Pool.
- Friendly
Name string The friendly name for the Virtual Desktop Host Pool.
- Id string
The provider-assigned unique ID for this managed resource.
- Load
Balancer stringType The type of load balancing performed by the Host Pool
- Location string
The location/region where the Virtual Desktop Host Pool is located.
- Maximum
Sessions intAllowed The maximum number of users that can have concurrent sessions on a session host.
- Name string
- Personal
Desktop stringAssignment Type The type of personal desktop assignment in use by the Host Pool
- Preferred
App stringGroup Type The preferred Application Group type for the Virtual Desktop Host Pool.
- Resource
Group stringName - Scheduled
Agent []GetUpdates Host Pool Scheduled Agent Update A
scheduled_agent_updates
block as defined below.- Start
Vm boolOn Connect Returns
true
if the Start VM on Connection Feature is enabled.- map[string]string
A mapping of tags to assign to the resource.
- Type string
The type of the Virtual Desktop Host Pool.
- Validate
Environment bool Returns
true
if the Host Pool is in Validation mode.
- custom
Rdp StringProperties The custom RDP properties string for the Virtual Desktop Host Pool.
- description String
The description for the Virtual Desktop Host Pool.
- friendly
Name String The friendly name for the Virtual Desktop Host Pool.
- id String
The provider-assigned unique ID for this managed resource.
- load
Balancer StringType The type of load balancing performed by the Host Pool
- location String
The location/region where the Virtual Desktop Host Pool is located.
- maximum
Sessions IntegerAllowed The maximum number of users that can have concurrent sessions on a session host.
- name String
- personal
Desktop StringAssignment Type The type of personal desktop assignment in use by the Host Pool
- preferred
App StringGroup Type The preferred Application Group type for the Virtual Desktop Host Pool.
- resource
Group StringName - scheduled
Agent List<GetUpdates Host Pool Scheduled Agent Update> A
scheduled_agent_updates
block as defined below.- start
Vm BooleanOn Connect Returns
true
if the Start VM on Connection Feature is enabled.- Map<String,String>
A mapping of tags to assign to the resource.
- type String
The type of the Virtual Desktop Host Pool.
- validate
Environment Boolean Returns
true
if the Host Pool is in Validation mode.
- custom
Rdp stringProperties The custom RDP properties string for the Virtual Desktop Host Pool.
- description string
The description for the Virtual Desktop Host Pool.
- friendly
Name string The friendly name for the Virtual Desktop Host Pool.
- id string
The provider-assigned unique ID for this managed resource.
- load
Balancer stringType The type of load balancing performed by the Host Pool
- location string
The location/region where the Virtual Desktop Host Pool is located.
- maximum
Sessions numberAllowed The maximum number of users that can have concurrent sessions on a session host.
- name string
- personal
Desktop stringAssignment Type The type of personal desktop assignment in use by the Host Pool
- preferred
App stringGroup Type The preferred Application Group type for the Virtual Desktop Host Pool.
- resource
Group stringName - scheduled
Agent GetUpdates Host Pool Scheduled Agent Update[] A
scheduled_agent_updates
block as defined below.- start
Vm booleanOn Connect Returns
true
if the Start VM on Connection Feature is enabled.- {[key: string]: string}
A mapping of tags to assign to the resource.
- type string
The type of the Virtual Desktop Host Pool.
- validate
Environment boolean Returns
true
if the Host Pool is in Validation mode.
- custom_
rdp_ strproperties The custom RDP properties string for the Virtual Desktop Host Pool.
- description str
The description for the Virtual Desktop Host Pool.
- friendly_
name str The friendly name for the Virtual Desktop Host Pool.
- id str
The provider-assigned unique ID for this managed resource.
- load_
balancer_ strtype The type of load balancing performed by the Host Pool
- location str
The location/region where the Virtual Desktop Host Pool is located.
- maximum_
sessions_ intallowed The maximum number of users that can have concurrent sessions on a session host.
- name str
- personal_
desktop_ strassignment_ type The type of personal desktop assignment in use by the Host Pool
- preferred_
app_ strgroup_ type The preferred Application Group type for the Virtual Desktop Host Pool.
- resource_
group_ strname - scheduled_
agent_ Sequence[Getupdates Host Pool Scheduled Agent Update] A
scheduled_agent_updates
block as defined below.- start_
vm_ boolon_ connect Returns
true
if the Start VM on Connection Feature is enabled.- Mapping[str, str]
A mapping of tags to assign to the resource.
- type str
The type of the Virtual Desktop Host Pool.
- validate_
environment bool Returns
true
if the Host Pool is in Validation mode.
- custom
Rdp StringProperties The custom RDP properties string for the Virtual Desktop Host Pool.
- description String
The description for the Virtual Desktop Host Pool.
- friendly
Name String The friendly name for the Virtual Desktop Host Pool.
- id String
The provider-assigned unique ID for this managed resource.
- load
Balancer StringType The type of load balancing performed by the Host Pool
- location String
The location/region where the Virtual Desktop Host Pool is located.
- maximum
Sessions NumberAllowed The maximum number of users that can have concurrent sessions on a session host.
- name String
- personal
Desktop StringAssignment Type The type of personal desktop assignment in use by the Host Pool
- preferred
App StringGroup Type The preferred Application Group type for the Virtual Desktop Host Pool.
- resource
Group StringName - scheduled
Agent List<Property Map>Updates A
scheduled_agent_updates
block as defined below.- start
Vm BooleanOn Connect Returns
true
if the Start VM on Connection Feature is enabled.- Map<String>
A mapping of tags to assign to the resource.
- type String
The type of the Virtual Desktop Host Pool.
- validate
Environment Boolean Returns
true
if the Host Pool is in Validation mode.
Supporting Types
GetHostPoolScheduledAgentUpdate
- Enabled bool
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- Schedules
List<Get
Host Pool Scheduled Agent Update Schedule> A
schedule
block as defined below.- Timezone string
The time zone in which the agent update schedule will apply.
- Use
Session boolHost Timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
- Enabled bool
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- Schedules
[]Get
Host Pool Scheduled Agent Update Schedule A
schedule
block as defined below.- Timezone string
The time zone in which the agent update schedule will apply.
- Use
Session boolHost Timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
- enabled Boolean
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- schedules
List<Get
Host Pool Scheduled Agent Update Schedule> A
schedule
block as defined below.- timezone String
The time zone in which the agent update schedule will apply.
- use
Session BooleanHost Timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
- enabled boolean
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- schedules
Get
Host Pool Scheduled Agent Update Schedule[] A
schedule
block as defined below.- timezone string
The time zone in which the agent update schedule will apply.
- use
Session booleanHost Timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
- enabled bool
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- schedules
Sequence[Get
Host Pool Scheduled Agent Update Schedule] A
schedule
block as defined below.- timezone str
The time zone in which the agent update schedule will apply.
- use_
session_ boolhost_ timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
- enabled Boolean
Are scheduled updates of the AVD agent components (RDAgent, Geneva Monitoring agent, and side-by-side stack) enabled on session hosts.
- schedules List<Property Map>
A
schedule
block as defined below.- timezone String
The time zone in which the agent update schedule will apply.
- use
Session BooleanHost Timezone Specifies whether scheduled agent updates should be applied based on the timezone of the affected session host.
GetHostPoolScheduledAgentUpdateSchedule
- day_
of_ strweek The day of the week on which agent updates should be performed.
- hour_
of_ intday The hour of day the update window should start.
Package Details
- Repository
- Azure Classic pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
azurerm
Terraform Provider.