Share via


New-AzureServiceRemoteDesktopExtensionConfig

Genera una configuración de extensión de Escritorio remoto para una implementación.

Nota

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

Syntax

New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceRemoteDesktopExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet New-AzureServiceRemoteDesktopExtensionConfig genera una configuración para una extensión de escritorio remoto para una implementación.

Ejemplos

Ejemplo 1: Generación de una configuración de extensión de Escritorio remoto

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred

Este comando genera una configuración de extensión de Escritorio remoto para las credenciales especificadas.

Ejemplo 2: Generación de una configuración de extensión de Escritorio remoto para un rol especificado

PS C:\> $rdpConfig = New-AzureServiceRemoteDesktopExtensionConfig -Credential $cred -Role "WebRole01"

Este comando genera una configuración de extensión de escritorio remoto para las credenciales especificadas y el rol WebRole01.

Parámetros

-CertificateThumbprint

Especifica una huella digital de certificado que se va a usar para cifrar la configuración privada. Este certificado ya debe existir en el almacén de certificados. Si no especifica un certificado, este cmdlet crea un certificado.

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

-Credential

Especifica las credenciales que se van a habilitar para escritorio remoto. Las credenciales incluyen un nombre de usuario y una contraseña.

Type:PSCredential
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Expiration

Especifica un objeto DateTime que permite al usuario especificar cuándo expira la cuenta de usuario.

Type:DateTime
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

Especifica el identificador de extensión.

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

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica una variable de información.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-Role

Especifica una matriz opcional de roles para los que especificar la configuración de Escritorio remoto. Si no se especifica este parámetro, la configuración de Escritorio remoto se aplica como configuración predeterminada para todos los roles.

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

-ThumbprintAlgorithm

Especifica un algoritmo hash de huella digital que se usa con la huella digital para identificar el certificado. Este parámetro es opcional y el valor predeterminado es sha1.

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

-Version

Especifica la versión de la extensión.

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

-X509Certificate

Especifica un certificado x509 que, cuando se especifique, se cargará automáticamente en el servicio en la nube y se usará para cifrar la configuración privada de la extensión.

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