Partager via

Set-AzureServiceRemoteDesktopExtension

  • Référence
Module:
Azure

Active l’extension Bureau à distance sur les rôles spécifiés ou tous les rôles sur un service déployé ou lors du 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.

Important

Services Cloud (classique) est désormais déconseillé pour les nouveaux clients et sera supprimé le 31 août 2024 pour tous les clients. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

Syntaxe

Set-AzureServiceRemoteDesktopExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-Credential] <PSCredential>
   [[-Expiration] <DateTime>]
   [[-Version] <String>]
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceRemoteDesktopExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-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 Set-AzureServiceRemoteDesktopExtension active l’extension Bureau à distance sur les rôles spécifiés ou tous les rôles sur un service déployé ou lors du déploiement.

Exemples

Exemple 1 : Activer l’extension Bureau à distance

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds

Cette commande active l’extension Bureau à distance pour le service spécifié.

Exemple 2 : Activer l’extension Bureau à distance pour un rôle spécifié

PS C:\> Set-AzureServiceRemoteDesktopExtension -ServiceName $svc -Credentials $creds -Role "WebRole1"

Cette commande active l’extension Bureau à distance pour le service et le rôle spécifiés.

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:3
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:5
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 date/heure qui permet à l’utilisateur de spécifier à l’expiration du compte d’utilisateur.

Type:DateTime
Position:6
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:8
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:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ServiceName

Spécifie le nom du service Azure du déploiement.

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

-Slot

Spécifie l’environnement du déploiement à modifier. Les valeurs acceptables pour ce paramètre sont : Production, Préproduction.

Type:String
Position:1
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:4
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:7
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 est automatiquement chargé sur le service cloud et utilisé pour chiffrer la configuration privée de l’extension.

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