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