New-RdsHostPool

Referens

Modul:: WindowsVirtualDesktopPowershell

Skapar en värdpool.

Syntax

New-RdsHostPool
   [-TenantName] <String>
   [-Name] <String>
   [-ValidationEnv <bool>]
   [-Ring <int>]
   [-AssignmentType {Automatic | Direct}]
   [-Description <String>]
   [-FriendlyName <String>]
   [-Persistent]
   [<CommonParameters>]

Description

Skapar en värdpool i en klientorganisation. Värdpoolen innehåller en eller flera sessionsvärdar där användare kan ansluta för att köra program, spara filer och använda resurser på dessa värdar.

När du skapar kan du välja att skapa en beständig värdpool med hjälp av den beständiga flaggan. Genom att skapa en beständig värdpool ansluter användaren alltid till samma sessionsvärd för sina sessioner. Om du inte använder den här flaggan skapas en poolbaserad värdpool. I en poolbaserad värdpool är användarna anslutna till en sessionsvärd i poolen som väljs dynamiskt av lastbalanseraren.

Exempel

Exempel 1: Skapa en poolbaserad värdpool

PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoHostPool"

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : BreadthFirst
ValidationEnv         : False
Ring                  : 
AssignmentType        :

Det här kommandot skapar en ny poolbaserad värdpool i den angivna klientorganisationen. Värdpoolen fylls i med några fördefinierade värden. Om du vill ändra dessa värden kör du cmdleten Set-RdsHostPool.

Exempel 2: Skapa en personlig skrivbordsvärdpool

PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoPersonal" -Persistent

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoPersonal
FriendlyName          :
Description           :
Persistent            : True
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : False
Ring                  : 
AssignmentType        : Automatic

Det här kommandot skapar en ny personlig skrivbordsvärdpool i den angivna klientorganisationen. Om du inte anger tilldelningstypen när du kör kommandot anges den personliga skrivbordsvärdpoolen till automatisk tilldelning. Om du vill ändra tilldelningstyp eller någon annan egenskap för värdpoolen kör du cmdleten Set-RdsHostPool.

Exempel 3: Skapa en valideringsvärdpool

PS C:\> New-RdsHostPool -TenantName "contoso" -Name "contosoValidation" -ValidationEnv $true

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoValidation
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     :
MaxSessionLimit       : 999999
LoadBalancerType      : Persistent
ValidationEnv         : True
Ring                  : 
AssignmentType        : Automatic

Det här kommandot skapar en ny pool, en valideringsvärdpool i den angivna klientorganisationen. Valideringsvärdpoolen får tjänstuppdateringar snabbare, så att du kan testa eventuella tjänständringar innan de distribueras brett i produktion. Om du vill ändra värdpoolen så att den inte längre är en valideringsvärdpool kör du cmdleten Set-RdsHostPool.

Parametrar

-AssignmentType

Tilldelningstypen för den personliga skrivbordsvärdpoolen:

Automatisk, vilket innebär att användare automatiskt tilldelas en sessionsvärd på sin första anslutning till värdpoolen.
Direkt, vilket innebär att användarna måste tilldelas direkt till en sessionsvärd i poolen innan de kan ansluta.

Type:	PersonalDesktopAssignmentType
Accepted values:	Automatic, Direct
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

En sträng på 512 tecken som beskriver HostPool för att hjälpa administratörer. Alla tecken tillåts.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FriendlyName

En sträng på 256 tecken som är avsedd att visas för slutanvändare. Alla tecken tillåts.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Namnet på värdpoolen, som måste vara unikt i klientorganisationen.

Type:	String
Aliases:	HostPoolName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Persistent

En växel som anger att värdpoolen ska markeras som beständig.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantName

Namnet på klientorganisationen.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ValidationEnv

Ett booleskt värde som anger om värdpoolen ska behandlas som en valideringsvärdpool. Valideringsvärdpooler tar emot tjänstuppdateringar snabbare än värdpooler som inte valideras, så att du kan testa tjänständringar innan de distribueras brett till produktion.

Type:	String
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool