Set-RdsSessionHost
Nastaví stav hostitele relace.
Syntaxe
Default (Výchozí)
Set-RdsSessionHost
[-TenantName] <String>
[-HostPoolName] <String>
[-Name] <String>
[-AllowNewSession]
[-AssignedUser]
[<CommonParameters>]
Description
Rutina Set-RdsSessionHost nastaví stav určeného hostitele relace. Nová připojení k hostiteli relace můžete zakázat nebo povolit. Změna této vlastnosti na hostiteli relace nemá vliv na žá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 vyprázdně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 nebude uživatel 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 vyprázdně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 osobní relace 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í hostitele relace v osobním fondu hostitelů pro stolní počítače k user1@contoso.com. Tento uživatel se nyní při připojování k fondu připojí k tomuto hostiteli relace.
Parametry
-AllowNewSession
Spínač se dvěma potenciálními hodnotami:
- True, což určuje, že hostiteli relace může zprostředkovatel přiřadit nové uživatelské relace.
- False, což znamená, že hostiteli relace nebudou přiřazeny žádné nové uživatelské relace (neboli režim vyprázdnění).
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AssignedUser
Uživatel, který má být přiřazen k hostiteli osobní relace plochy.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-HostPoolName
Název fondu hostitelů.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Plně kvalifikovaný název domény (FQDN) hostitele relace.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Název hostitele relace |
Sady parametrů
(All)
| Position: | 2 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-TenantName
Název tenanta.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.