New-RdsHostPool

Skapar en värdpool.

Syntax

Default (Standard)

New-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [-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 poolad 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 poolad 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 värdpool för skrivbordet

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 ställs värdpoolen för det personliga skrivbordet in på automatisk tilldelning. Om du vill ändra tilldelningstypen 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 poolad valideringsvärdpool i den angivna klientorganisationen. Valideringsvärdpoolen tar emot 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 värdpoolen för det personliga skrivbordet:

  • Automatisk, vilket innebär att användarna automatiskt tilldelas en sessionsvärd vid 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.

Parameteregenskaper

Typ:PersonalDesktopAssignmentType
Standardvärde:None
Godkända värden:Automatic, Direct
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FriendlyName

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:HostPoolName (på engelska)

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Persistent

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TenantName

Namnet på hyresgästen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ValidationEnv

Ett booleskt värde som anger om värdpoolen ska behandlas som en valideringsvärdpool. Valideringsvärdpooler tar emot tjänstuppdateringar i snabbare takt än icke-valideringsvärdpooler, vilket gör att du kan testa tjänständringar innan de distribueras brett till produktion.

Parameteregenskaper

Typ:String
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool