Condividi tramite

Set-RdsHostPool

Modulo:
Microsoft.RDInfra.RDPowershell Module

Imposta le proprietà di un pool di host.

Sintassi

HP4 (impostazione predefinita). 

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-FriendlyName <String>]
    [-Description <String>]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP5 

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-BreadthFirstLoadBalancer]
    [-MaxSessionLimit <Int32>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP6 

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    -MaxSessionLimit <Int32>
    [-DepthFirstLoadBalancer]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP3 

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-CustomRdpProperty <String>]
    [-ValidationEnv <bool>]
    [<CommonParameters>]

HP7 

Set-RdsHostPool
    [-TenantName] <String>
    [-Name] <String>
    [-ValidationEnv <bool>]
    [-Ring <int>]
    [<CommonParameters>]

Descrizione

Il cmdlet Set-RdsHostPool imposta le proprietà per il pool di host specificato. Per questo cmdlet sono disponibili tre set di parametri. Il primo viene utilizzato per disabilitare i dischi del profilo utente. Il secondo viene utilizzato per abilitare i dischi dei profili utente. Il terzo viene utilizzato per impostare tutte le altre proprietà del pool di host.

Esempio

Esempio 1: Impostare il pool di host per l'uso del bilanciamento del carico in base alla profondità

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -DepthFirstLoadBalancer -MaxSessionLimit 10

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

Questo comando imposta il pool di host per l'utilizzo del bilanciamento del carico in base alla profondità, in modo che tutti gli utenti in ingresso vengano indirizzati a un host di sessione specifico fino a quando non raggiunge MaxSessionLimit, specificato come 10 in questo esempio. Il parametro MaxSessionLimit è un requisito per l'impostazione del bilanciamento del carico depth-first, poiché le connessioni non verranno distribuite agli host di sessione successivi fino a quando non viene raggiunto questo limite di sessioni nel primo host di sessione.

Esempio 2: Impostare il pool di host per l'uso del bilanciamento del carico in ampiezza

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

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

Questo comando imposta il pool di host per l'utilizzo del bilanciamento del carico in base all'ampiezza, in modo che gli utenti in ingresso vengano indirizzati in modo uniforme tra gli host di sessione nel pool di host. Il parametro MaxSessionLimit è facoltativo poiché il bilanciamento del carico in modalità breadth-first è meno restrittivo del bilanciamento del carico in modalità depth-first.

Esempio 3: Impostare il pool di host da considerare come ambiente di convalida

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoHostPool" -ValidationEnv $true

TenantName            : contoso
TenantGroupName       : Default Tenant Group
HostPoolName          : contosoHostPool
FriendlyName          :
Description           :
Persistent            : False
CustomRdpProperty     : use multimon:i:0;
MaxSessionLimit       : 10
LoadBalancerType      : BreadthFirst
ValidationEnv         : True
Ring                  :
AssignmentType        :

Questo comando imposta il pool di host in modo che sia un pool di host di convalida. 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.

Esempio 4: Impostare il pool di host per l'uso dell'assegnazione diretta

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

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

Questo comando imposta il pool di host in modo che utilizzi l'assegnazione diretta per determinare l'host della sessione desktop personale da assegnare all'utente. Con l'assegnazione diretta, l'utente deve essere assegnato a un host di sessione prima di connettersi al pool di host.

Esempio 5: Impostare il pool di host per l'uso dell'assegnazione automatica

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

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

Questo comando imposta il pool di host in modo che utilizzi l'assegnazione automatica per determinare l'host della sessione desktop personale da assegnare all'utente. Con l'assegnazione automatica, non è necessario assegnare l'utente a un host di sessione prima di connettersi al pool di host.

Esempio 4: Impostare il pool di host per l'uso dell'assegnazione diretta

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Direct

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

Questo comando imposta il pool di host in modo che utilizzi l'assegnazione diretta per determinare l'host della sessione desktop personale da assegnare all'utente. Con l'assegnazione diretta, l'utente deve essere assegnato a un host di sessione prima di connettersi al pool di host.

Esempio 5: Impostare il pool di host per l'uso dell'assegnazione automatica

PS C:\> Set-RdsHostPool -TenantName "contoso" -Name "contosoPersonalDesktops" -AssignmentType Automatic

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

Questo comando imposta il pool di host in modo che utilizzi l'assegnazione automatica per determinare l'host della sessione desktop personale da assegnare all'utente. Con l'assegnazione automatica, non è necessario assegnare l'utente a un host di sessione prima di connettersi al pool di host.

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

-BreadthFirstLoadBalancer

Passare per abilitare l'uso del bilanciamento del carico breadth-first per il pool di host. L'ampiezza indica che le nuove sessioni utente vengono indirizzate all'host della sessione con il minor numero di sessioni utente.

Proprietà dei parametri

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

Set di parametri

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

-CustomRdpProperty

Specifica le impostazioni RDP (Remote Desktop Protocol) da includere nei file RDP per tutti i programmi RemoteApp e i desktop remoti pubblicati in questa raccolta. Per altre informazioni, vedere Impostazioni dei file RDP di Desktop remoto supportate .

Proprietà dei parametri

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

Set di parametri

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

-DepthFirstLoadBalancer

Passare per abilitare l'uso del bilanciamento del carico depth-first per il pool di host. Depth-first indica che le nuove sessioni utente vengono indirizzate all'host della sessione con il numero più alto di sessioni utente che non ha già raggiunto il limite massimo di sessioni.

Proprietà dei parametri

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

Set di parametri

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

-Description

Descrizione del pool di host.

Proprietà dei parametri

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

Set di parametri

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

-FriendlyName

Nome descrittivo del pool di host da visualizzare.

Proprietà dei parametri

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

Set di parametri

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

-MaxSessionLimit

Numero massimo di sessioni consentite per ogni host di sessione nel pool di host. Quando la modalità depth-first è impostata per il bilanciamento del carico, questo valore viene utilizzato per determinare quando interrompere il bilanciamento del carico degli utenti a un host e iniziare a inviare gli utenti all'host successivo.

Proprietà dei parametri

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

Set di parametri

HP4
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
HP5
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.

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

-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