Condividi tramite


New-RdsHostPool

Crea un pool di host.

Sintassi

Default (impostazione predefinita).

New-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [-Description <String>]
    [-FriendlyName <String>]
    [-Persistent]
    [<CommonParameters>]

Descrizione

Crea un pool di host all'interno di un tenant. Il pool di host contiene uno o più host di sessione a cui gli utenti possono connettersi per eseguire programmi, salvare file e utilizzare le risorse su tali host.

In fase di creazione, è possibile decidere di creare un pool di host persistente utilizzando il flag persistente. Creando un pool di host persistente, l'utente si connetterà sempre allo stesso host di sessione per le sessioni. Se non si utilizza questo flag, viene creato un pool di host in pool. In un pool di host in pool, gli utenti sono connessi a un host di sessione nel pool selezionato dinamicamente dal servizio di bilanciamento del carico.

Esempio

Esempio 1: Creare un pool di host in pool

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        :

Questo comando crea un nuovo pool di host in pool nel tenant specificato. Il pool di host viene popolato con alcuni valori predefiniti. Per modificare questi valori, eseguire il cmdlet Set-RdsHostPool.

Esempio 2: Creare un pool di host desktop personale

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

Questo comando crea un nuovo pool di host desktop personali nel tenant specificato. Se non si specifica il tipo di assegnazione durante l'esecuzione del comando, il pool di host desktop personale verrà impostato per l'assegnazione automatica. Per modificare il tipo di assegnazione o qualsiasi altra proprietà per il pool di host, eseguire il cmdlet Set-RdsHostPool.

Esempio 3: Creare un pool di host di convalida

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

Questo comando crea un nuovo pool di host di convalida in pool nel tenant specificato. Il pool di host di convalida riceverà gli aggiornamenti del servizio con una cadenza più rapida, consentendo di testare eventuali modifiche al servizio prima che vengano distribuite su larga scala nell'ambiente di produzione. Per modificare il pool di host in modo che non sia più un pool di host di convalida, eseguire il cmdlet Set-RdsHostPool.

Parametri

-AssignmentType

Il tipo di assegnazione per il pool di host desktop personale:

  • Automatico, il che significa che agli utenti verrà assegnato automaticamente un host di sessione alla prima connessione al pool di host.
  • Diretto, il che significa che gli utenti devono essere assegnati direttamente a un host di sessione nel pool prima di potersi connettere.

Proprietà dei parametri

Tipo:PersonalDesktopAssignmentType
Valore predefinito:None
Valori accettati:Automatic, Direct
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

Una stringa di 512 caratteri che descrive l'HostPool per aiutare gli amministratori. Qualsiasi carattere è consentito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FriendlyName

Stringa di 256 caratteri destinata alla visualizzazione agli utenti finali. Qualsiasi carattere è consentito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome del pool di host, che deve essere univoco nel tenant.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:HostPoolName

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Persistent

Opzione che indica di contrassegnare il pool di host come persistente.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TenantName

Nome del tenant.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ValidationEnv

Un valore booleano che indica se il pool di host deve essere considerato come un pool di host di convalida. I pool di host di convalida ricevono gli aggiornamenti del servizio con una cadenza più rapida rispetto ai pool di host non di convalida, consentendo di testare le modifiche del servizio prima che vengano distribuite su larga scala nell'ambiente di produzione.

Proprietà dei parametri

Tipo:String
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtHostPool