Set-RdsSessionHost
Anger tillståndet för en sessionsvärd.
Syntax
Default (Standard)
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 inte några användarsessioner på sessionsvärden.
Exempel
Exempel 1: Inaktivera nya anslutningar till en sessionsvärd (dvs. 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 en kandidat för belastningsutjämning. Alla befintliga sessioner på servern kommer att finnas kvar där tills användaren loggas ut. En administratör kan tvinga fram en utloggning med cmdleten Invoke-RdsUserSessionLogoff.
Exempel 2: Aktivera nya anslutningar till en sessionsvärd (d.v.s. ta bort värden från tömningsläge)
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
Det här kommandot gör det möjligt för sessionsvärden att ta emot nya anslutningar och är nu en kandidat för belastningsutjämning.
Exempel 3: Tilldela en användare till en personlig värd för skrivbordssessionen
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 kommer nu att ansluta till den här sessionsvärden när han ansluter till poolen.
Parametrar
-AllowNewSession
En switch med två potentialvärden:
- True, vilket anger att sessionsvärden kan tilldelas nya användarsessioner av den asynkrona meddelandekön.
- Falskt, vilket anger att sessionsvärden inte kommer att tilldelas några nya användarsessioner (även kallat tömningsläge).
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 |
-AssignedUser
Användaren ska tilldelas den personliga skrivbordssessionsvärden.
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 |
-HostPoolName
Namnet på värdpoolen.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
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 |
-Name
Det fullständigt kvalificerade domännamnet (FQDN) för sessionsvärden.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Värdnamn för session |
Parameteruppsättningar
(All)
| Position: | 2 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| 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 |
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.