Delen via


Set-RdsSessionHost

Hiermee stelt u de status van een sessiehost in.

Syntax

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

Description

De cmdlet Set-RdsSessionHost stelt de status van de opgegeven sessiehost in. U kunt nieuwe verbindingen met de sessiehost uitschakelen of inschakelen. Het wijzigen van deze eigenschap op de sessiehost heeft geen invloed op gebruikerssessies op de sessiehost.

Voorbeelden

Voorbeeld 1: nieuwe verbindingen met een sessiehost uitschakelen (ook wel de host instellen op de drain-modus)

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

Met deze opdracht wordt de sessiehost uitgeschakeld voor het ontvangen van nieuwe verbindingen en wordt deze verwijderd als een kandidaat voor taakverdeling. Alle bestaande sessies op de server blijven daar staan totdat de gebruiker wordt afgemeld. Een beheerder kan een afmelding afdwingen met de cmdlet Invoke-RdsUserSessionLogoff.

Voorbeeld 2: nieuwe verbindingen met een sessiehost inschakelen (ook wel de host verwijderen uit de drainmodus)

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

Met deze opdracht kan de sessiehost nieuwe verbindingen ontvangen en is nu een kandidaat voor taakverdeling.

Voorbeeld 3: Een gebruiker toewijzen aan een persoonlijke bureaubladsessiehost

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

Met deze opdracht wordt de sessiehost in een persoonlijke bureaubladhostgroep toegewezen aan user1@contoso.com. Deze gebruiker maakt nu verbinding met deze sessiehost wanneer deze verbinding maakt met de pool.

Parameters

-AllowNewSession

Een schakeloptie met twee mogelijke waarden:

  • True, waarbij wordt opgegeven dat de sessiehost nieuwe gebruikerssessies kan worden toegewezen door de broker.
  • False, waarbij wordt opgegeven dat er geen nieuwe gebruikerssessies worden toegewezen aan de sessiehost (ook wel drainmodus genoemd).
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AssignedUser

Gebruiker die moet worden toegewezen aan de host van de persoonlijke bureaubladsessie.

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

-HostPoolName

De naam van de hostgroep.

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

-Name

De FQDN (Fully Qualified Domain Name) van de sessiehost.

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

-TenantName

De naam van de tenant.

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

Invoerwaarden

System.String

Uitvoerwaarden

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost