Set-RdsSessionHost

Referens

Modul:: WindowsVirtualDesktopPowershell

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 status 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 (aka, ställ in värden på avloppslä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 finns kvar där tills användaren är utloggad. En administratör kan framtvinga en utloggning med cmdleten Invoke-RdsUserSessionLogoff.

Exempel 2: Aktivera nya anslutningar till en sessionsvärd (aka, ta bort värden från avloppslä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 värd för en personlig skrivbordssession

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 sessionsvärden när han eller hon ansluter till poolen.

Parametrar

-AllowNewSession

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

Sant, anger att sessionsvärden kan tilldelas nya användarsessioner av den asynkrona meddelandekön.
Falskt, anger att sessionsvärden inte ska tilldelas några nya användarsessioner (även kallat dräneringsläge).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssignedUser

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostPoolName

Namnet på värdpoolen.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	SessionHostName
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TenantName

Namnet på klientorganisationen.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Indata

System.String

Utdata

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost

Dela via