Set-RdsSessionHost

  • Başvuru
Modül:
WindowsVirtualDesktopPowershell

Oturum konağı durumunu ayarlar.

Syntax

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

Description

Set-RdsSessionHost cmdlet'i belirtilen oturum konağı durumunu ayarlar. Oturum konağına yeni bağlantıları devre dışı bırakabilir veya etkinleştirebilirsiniz. Oturum ana bilgisayarında bu özelliğin değiştirilmesi, oturum konağındaki hiçbir kullanıcı oturumunu etkilemez.

Örnekler

Örnek 1: Oturum konağına yeni bağlantıları devre dışı bırakma (başka bir deyişle, konağı boşaltma moduna ayarlayı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

Bu komut, oturum ana bilgisayarının yeni bağlantıları almasını devre dışı bırakır ve yük dengeleme adayı olarak kaldırır. Sunucudaki mevcut oturumlar, kullanıcı oturumu kapatılana kadar orada kalır. Yönetici, Invoke-RdsUserSessionLogoff cmdlet'iyle oturum kapatmaya zorlayabilir.

Örnek 2: Oturum konağına yeni bağlantıları etkinleştirme (başka bir deyişle, konağı boşaltma modundan çıkarma)

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

Bu komut, oturum ana bilgisayarının yeni bağlantılar almasını sağlar ve artık yük dengeleme için bir adaydır.

Örnek 3: Kişisel masaüstü oturumu konağına kullanıcı atama

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

Bu komut, kişisel masaüstü konak havuzundaki oturum ana bilgisayarını öğesine user1@contoso.comatar. Bu kullanıcı artık havuza bağlanırken bu oturum konağına bağlanacak.

Parametreler

-AllowNewSession

İki olası değer içeren bir anahtar:

  • Doğru, oturum konağına aracı tarafından yeni kullanıcı oturumları atanabileceğini belirtir.
  • Yanlış, oturum konağına yeni kullanıcı oturumları (başka bir deyişle boşaltma modu) atanmayacak.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AssignedUser

Kişisel masaüstü oturumu konağına atanacak kullanıcı.

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

-HostPoolName

Konak havuzunun adı.

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

-Name

Oturum ana bilgisayarının tam etki alanı adı (FQDN).

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

-TenantName

Kiracının adı.

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

Girişler

System.String

Çıkışlar

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost