Set-RdsSessionHost

Referensi

Modul:: WindowsVirtualDesktopPowershell

Mengatur status host sesi.

Sintaks

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

Deskripsi

Cmdlet Set-RdsSessionHost mengatur status host sesi yang ditentukan. Anda dapat menonaktifkan atau mengaktifkan koneksi baru ke host sesi. Mengubah properti ini pada host sesi tidak memengaruhi sesi pengguna apa pun pada host sesi.

Contoh

Contoh 1: Nonaktifkan koneksi baru ke host sesi (alias, atur host ke mode pengurasan)

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

Perintah ini menonaktifkan host sesi menerima koneksi baru dan menghapusnya sebagai kandidat untuk penyeimbangan beban. Setiap sesi yang ada di server akan tetap ada sampai pengguna keluar. Administrator dapat memaksa logoff dengan cmdlet Invoke-RdsUserSessionLogoff.

Contoh 2: Aktifkan koneksi baru ke host sesi (alias, hapus host dari mode pengurasan)

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

Perintah ini memungkinkan host sesi untuk menerima koneksi baru dan sekarang menjadi kandidat untuk penyeimbangan beban.

Contoh 3: Menetapkan pengguna ke host sesi desktop pribadi

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

Perintah ini menetapkan host sesi di kumpulan host desktop pribadi ke user1@contoso.com. Pengguna ini sekarang akan terhubung ke host sesi ini saat menyambungkan ke kumpulan.

Parameter

-AllowNewSession

Sakelar dengan dua nilai potensial:

Benar, menentukan bahwa host sesi dapat diberi sesi pengguna baru oleh broker.
Salah, menentukan bahwa host sesi tidak akan diberi sesi pengguna baru apa pun (alias mode pengurasan).

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

-AssignedUser

Pengguna yang akan ditetapkan ke host sesi desktop pribadi.

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

-HostPoolName

Nama kumpulan host.

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

-Name

Nama domain yang sepenuhnya memenuhi syarat (FQDN) dari host sesi.

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

-TenantName

Nama penyewa.

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

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtSessionHost

Bagikan melalui