Set-AzureServiceExtension

Ajoute une extension de service cloud à un déploiement.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Important

Les services cloud (classiques) sont désormais peu pris en compte pour les nouveaux clients et seront supprimés le 31 août 2024 pour tous les clients. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement Azure Resource Manager azure Cloud Services (support étendu).

Syntax

Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceExtension
   [[-ServiceName] <String>]
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’cmdlet Set-AzureServiceExtension ajoute une extension de service cloud à un déploiement.

Exemples

Exemple 1 : ajouter un service cloud à un déploiement

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -ExtensionName "RDP" -Version "1.0" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Cette commande ajoute un service cloud à un déploiement.

Exemple 2 : ajouter un service cloud à un déploiement pour un rôle spécifique

PS C:\> Set-AzureServiceExtension -Service $Svc -Slot "Production" -Role "WebRole1" -ExtensionName "RDP" -ProviderNamespace "Microsoft.Windows.Azure.Extensions" -PublicConfiguration $P1 -PrivateConfiguration $P2;

Cette commande ajoute un service cloud à un déploiement pour un rôle spécifié.

Paramètres

-CertificateThumbprint

Spécifie une empreinte miniature 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 cmdlet crée un certificat.

Type:String
Position:3
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ExtensionId

Spécifie l’ID d’extension.

Type:String
Position:10
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ExtensionName

Indique le nom de l’extension.

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

Indique comment cette cmdlet répond à un événement d’information.

Les valeurs acceptables pour ce paramètre sont les suivants :

  • Continuer
  • Ignorer
  • Inquire
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InformationVariable

Spécifie une variable d’informations.

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

Spécifie le texte de la configuration privée.

Type:String
Position:8
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Profil

Indique le profil Azure à partir duquel cette cmdlet lit. Si vous ne spécifiez pas de profil, cette cmdlet lit le profil par défaut local.

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

Spécifie l’espace de noms du fournisseur d’extension.

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

Spécifie le texte de configuration public.

Type:String
Position:7
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Rôle

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

Type:String[]
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ServiceName

Indique le nom du service Azure du déploiement.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Slot

Spécifie l’environnement du déploiement à modifier. Les valeurs valides sont : Production ou Intermédiaire.

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

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

Type:String
Position:4
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Version

Spécifie la version de l’extension.

Type:String
Position:9
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-X509Certificate

Spécifie un certificat X.509 chargé automatiquement vers le service cloud et utilisé pour chiffrer la configuration privée de l’extension.

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