Set-RdsSessionHost

Reference

Modul:: WindowsVirtualDesktopPowershell

Nastaví stav hostitele relace.

Syntax

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

Description

Rutina Set-RdsSessionHost nastaví stav zadaného hostitele relace. Nová připojení k hostiteli relace můžete zakázat nebo povolit. Změna této vlastnosti na hostiteli relace neovlivní žádné uživatelské relace na hostiteli relace.

Příklady

Příklad 1: Zakázání nových připojení k hostiteli relace (neboli nastavení hostitele do režimu vyprazdňování)

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

Tento příkaz zakáže hostiteli relace přijímat všechna nová připojení a odebere ho jako kandidáta na vyrovnávání zatížení. Všechny existující relace na serveru tam zůstanou, dokud uživatel nebude odhlášený. Správce může vynutit odhlášení pomocí rutiny Invoke-RdsUserSessionLogoff.

Příklad 2: Povolení nových připojení k hostiteli relace (neboli odebrání hostitele z režimu vyprazdňování)

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

Tento příkaz umožňuje hostiteli relace přijímat nová připojení a je nyní kandidátem na vyrovnávání zatížení.

Příklad 3: Přiřazení uživatele k hostiteli relace osobní plochy

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

Tento příkaz přiřadí hostiteli relace ve fondu hostitelů osobní plochy k nástroji user1@contoso.com. Tento uživatel se teď při připojování k fondu připojí k tomuto hostiteli relace.

Parametry

-AllowNewSession

Přepínač se dvěma potenciálními hodnotami:

Ano, určuje, že zprostředkovatel může hostiteli relace přiřadit nové uživatelské relace.
Nepravda– určuje, že hostiteli relace nebudou přiřazeny žádné nové uživatelské relace (neboli režim vyprazdňování).

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

-AssignedUser

Uživatel, který má být přiřazen k hostiteli relace osobní plochy.

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

-HostPoolName

Název fondu hostitelů.

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

-Name

Plně kvalifikovaný název domény (FQDN) hostitele relace.

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

-TenantName

Název tenanta.

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

Vstupy

System.String

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost

Sdílet prostřednictvím