Partager via

New-AzureServiceRemoteDesktopExtensionConfig

  • Référence
Module:
Azure

Génère une configuration d’extension Bureau à distance pour un déploiement.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

L’applet de commande New-AzureServiceRemoteDesktopExtensionConfig génère une configuration pour une extension bureau à distance pour un déploiement.

Exemples

Exemple 1 : Générer une configuration d’extension Bureau à distance

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

Cette commande génère une configuration d’extension Bureau à distance pour les informations d’identification spécifiées.

Exemple 2 : Générer une configuration d’extension Bureau à distance pour un rôle spécifié

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

Cette commande génère une configuration d’extension Bureau à distance pour les informations d’identification spécifiées et le rôle WebRole01.

Paramètres

-CertificateThumbprint

Spécifie une empreinte numérique de certificat à utiliser pour chiffrer la configuration privée. Ce certificat doit déjà exister dans le magasin de certificats. Si vous ne spécifiez pas de certificat, cette applet de commande crée un certificat.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Credential

Spécifie les informations d’identification à activer pour le Bureau à distance. Les informations d’identification incluent un nom d’utilisateur et un mot de passe.

Type:PSCredential
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Expiration

Spécifie un objet DateTime qui permet à l’utilisateur de spécifier à l’expiration du compte d’utilisateur.

Type:DateTime
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ExtensionId

Spécifie l’ID d’extension.

Type:String
Position:6
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Alias:iv
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Role

Spécifie un tableau facultatif de rôles pour lesquels spécifier la configuration bureau à distance. Si ce paramètre n’est pas spécifié, la configuration bureau à distance est appliquée comme configuration par défaut pour tous les rôles.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ThumbprintAlgorithm

Spécifie un algorithme de hachage d’empreinte qui est utilisé avec l’empreinte numérique pour identifier le certificat. Ce paramètre est facultatif et la valeur par défaut est sha1.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Version

Spécifie la version de l’extension.

Type:String
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-X509Certificate

Spécifie un certificat x509 qui, lorsqu’il est spécifié, sera automatiquement chargé dans le service cloud et utilisé pour chiffrer la configuration privée de l’extension.

Type:X509Certificate2
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False