Dela via


Set-RdsSessionHost

Anger tillståndet för en sessionsvärd.

Syntax

Set-RdsSessionHost
   [-TenantName] <String>
   [-HostPoolName] <String>
   [-Name] <String>
   [-AllowNewSession]
   [-AssignedUser]
   [<CommonParameters>]

Description

Cmdleten Set-RdsSessionHost anger tillståndet för den angivna sessionsvärden. Du kan antingen inaktivera eller aktivera nya anslutningar till sessionsvärden. Om du ändrar den här egenskapen på sessionsvärden påverkas inga användarsessioner på sessionsvärden.

Exempel

Exempel 1: Inaktivera nya anslutningar till en sessionsvärd (aka, ställ in värden på tömningsläge)

PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -AllowNewSession $false

SessionHostName : sh1.contoso.com
TenantName      : contoso
TenantGroupName : Default Tenant Group
HostPoolName    : contosoHostPool
AllowNewSession : False
Sessions        : 1
LastHeartBeat   : 1/1/2018 12:00:00 PM
AgentVersion    : 1.0.0.1
AssignedUser    :
Status          : Available
StatusTimestamp : 1/1/2018 12:00:00 PM

Det här kommandot inaktiverar sessionsvärden från att ta emot nya anslutningar och tar bort den som kandidat för belastningsutjämning. Alla befintliga sessioner på servern kommer att finnas kvar tills användaren har loggats ut. En administratör kan tvinga fram en utloggning med cmdleten Invoke-RdsUserSessionLogoff.

Exempel 2: Aktivera nya anslutningar till en sessionsvärd (även kallat ta bort värden från avtappningsläget)

PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoHostPool" -Name "sh1.contoso.com" -AllowNewSession $true

SessionHostName : sh1.contoso.com
TenantName      : contoso
TenantGroupName : Default Tenant Group
HostPoolName    : contosoHostPool
AllowNewSession : True
Sessions        : 1
LastHeartBeat   : 1/1/2018 12:00:00 PM
AgentVersion    : 1.0.0.1
AssignedUser    :
Status          : Available
StatusTimestamp : 1/1/2018 12:00:00 PM

Med det här kommandot kan sessionsvärden ta emot nya anslutningar och är nu en kandidat för belastningsutjämning.

Exempel 3: Tilldela en användare till en personlig skrivbordssessionsvärd

PS C:\> Set-RdsSessionHost -TenantName "contoso" -HostPoolName "contosoPersonalDesktops" -Name "sh1.contoso.com" -AssignedUser user1@contoso.com

SessionHostName : sh1.contoso.com
TenantName      : contoso
TenantGroupName : Default Tenant Group
HostPoolName    : contosoPersonalDesktops
AllowNewSession : True
Sessions        : 1
LastHeartBeat   : 1/1/2018 12:00:00 PM
AgentVersion    : 1.0.0.1
AssignedUser    : user1@contoso.com
Status          : Available
StatusTimestamp : 1/1/2018 12:00:00 PM

Det här kommandot tilldelar sessionsvärden i en personlig skrivbordsvärdpool till user1@contoso.com. Den här användaren ansluter nu till den här sessionsvärden när den ansluter till poolen.

Parametrar

-AllowNewSession

En växel med två potentiella värden:

  • Sant, anger att sessionsvärden kan tilldelas nya användarsessioner av asynkron meddelandekö.
  • Falskt, anger att sessionsvärden inte kommer att tilldelas några nya användarsessioner (även kallat dräneringsläge).
Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AssignedUser

Användare som ska tilldelas till den personliga skrivbordssessionsvärden.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-HostPoolName

Namnet på värdpoolen.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Sessionsvärdens fullständigt kvalificerade domännamn (FQDN).

Typ:String
Alias:SessionHostName
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TenantName

Namnet på klientorganisationen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost