New-RdsRegistrationInfo
Crea información de registro para un grupo de hosts.
Sintaxis
Default (Es el valor predeterminado).
New-RdsRegistrationInfo
[-TenantName] <String>
[-HostPoolName] <String>
[-ExpirationHours <Int32>]
[<CommonParameters>]
Description
El cmdlet New-RdsRegistrationInfo crea nueva información de registro para el grupo de hosts especificado. El token de la información de registro debe proporcionarse al instalar el agente para registrar correctamente el host de sesión en el grupo de hosts.
Solo puede tener un conjunto de información de registro a la vez para un grupo de hosts determinado. Se producirá un error en este comando si el grupo de hosts ya tiene información de registro. Si desea rotar la información de registro, ejecute primero el cmdlet Remove-RdsRegistrationInfo.
Ejemplos
Ejemplo 1: Crear nueva información de registro para un grupo de hosts
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
Este comando crea nueva información de registro para el grupo de hosts. La información de registro es válida y se puede recuperar hasta que expire mediante el cmdlet Get-RdsRegistrationInfo.
Ejemplo 2: Cree una nueva información de registro para un grupo de hosts y guarde el token en un archivo de texto.
PS C:\> New-RdsRegistrationInfo -TenantName "contoso" -HostPoolName "contosoHostPool" -ExpirationHours 48 | Select-Object -ExpandProperty Token > .\registrationtoken.txt
Este comando crea nueva información de registro para el grupo de hosts y guarda el valor del token en el archivo registrationtoken.txt en el directorio local.
Parámetros
-ExpirationHours
Las horas que se van a agregar a la hora actual para marcar como caducidad la información de registro. El valor predeterminado es 48 horas.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-HostPoolName
Nombre del grupo de hosts.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-TenantName
El nombre del inquilino.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.