New-RdsRegistrationInfo

参考

模块:: WindowsVirtualDesktopPowershell

为主机池创建注册信息。

语法

New-RdsRegistrationInfo
   [-TenantName] <String>
   [-HostPoolName] <String>
   [-ExpirationHours <Int32>]
   [<CommonParameters>]

说明

New-RdsRegistrationInfo cmdlet 为指定的主机池创建新的注册信息。安装代理以成功将会话主机注册到主机池时，必须提供注册信息中的令牌。

对于给定主机池，一次只能有一组注册信息。如果主机池已有注册信息，此命令将失败。若要轮换注册信息，请先运行 Remove-RdsRegistrationInfo cmdlet。

示例

示例 1：为主机池创建新的注册信息

PS C:\> New-RdsRegistrationInfo -TenantName "contoso" -HostPoolName "contosoHostPool" -ExpirationHours 48

Token           : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx111111111111111111111111111111111111111111111111111111111
                  YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY222222222222222222222222222222222222222222222222222222222
                  zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz333333333333333333333333333333333333333333333333333333333
                  aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa444444444444444444444444444444444444444444444444444444444
                  bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb555555555555555555555555555555555555555555555555555555555
                  cccccccccccccccccccccccccccccccccccccccccccc666666666666666666666666666666666666666666666666666666666
                  dddddddddddddddddddddddddddddddddddddddddddd777777777777777777777777777777777777777777777777777777777
                  eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee88888888888888888888888888
ExpirationTime  : 1/3/2018 12:00:00 PM
TenantGroupName : Default Tenant Group
TenantName      : contoso
HostPoolName    : contosoHostPool

此命令为主机池创建新的注册信息。注册信息有效，可以检索到它使用 Get-RdsRegistrationInfo cmdlet 过期为止。

示例 2：为主机池创建新的注册信息，并将令牌保存到文本文件。

PS C:\> New-RdsRegistrationInfo -TenantName "contoso" -HostPoolName "contosoHostPool" -ExpirationHours 48 | Select-Object -ExpandProperty Token > .\registrationtoken.txt

此命令为主机池创建新的注册信息，并将令牌的值保存到本地目录中的 registrationtoken.txt 文件中。

参数

-ExpirationHours

要添加到当前时间的小时数，以标记为注册信息的到期时间。默认值为 48 小时。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HostPoolName

主机池的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TenantName

租户的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

System.String

输出

Microsoft.RDInfra.RDManagementData.RdMgmtRegistrationInfo

通过