Set-AzureServiceDiagnosticsExtension
Active l’extension Diagnostics Azure sur les rôles spécifiés ou tous les rôles sur un service déployé ou lors du 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
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) .
Syntax
Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[-DiagnosticsConfigurationPath] <String>
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-CertificateThumbprint] <String>]
[[-ThumbprintAlgorithm] <String>]
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[-DiagnosticsConfigurationPath] <String>
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[-DiagnosticsConfiguration] <ExtensionConfigurationInput[]>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureServiceDiagnosticsExtension active l’extension Diagnostics Azure 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 Diagnostics Azure
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML
Cette commande active l’extension Diagnostics Azure pour tous les rôles.
Exemple 2 : Activer l’extension Diagnostics Azure pour un rôle spécifié
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML -Role "WebRole01"
Cette commande active l’extension Diagnostics Azure pour un rôle spécifié.
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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiagnosticsConfiguration
Spécifie un tableau de configuration pour Diagnostics Azure.
Type: | ExtensionConfigurationInput[] |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiagnosticsConfigurationPath
Spécifie la configuration des diagnostics Azure. Vous pouvez télécharger le schéma à l’aide de la commande suivante :
(Get-AzureServiceAvailableExtension -ExtensionName 'PaaSDiagnostics' -ProviderNamespace 'Microsoft.Azure.Diagnostics').PublicConfigurationSchema | Out-File -Encoding utf8 -FilePath 'WadConfig.xsd'
Type: | String |
Position: | 9 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionId
Spécifie l’ID d’extension
Type: | String |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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
- Renseignez-vous
- SilentlyContinue
- Arrêter
- Suspendre
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
Spécifie une variable d’informations.
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
Spécifie un tableau facultatif de rôles pour lesquels spécifier la configuration diagnostics Azure. Si vous ne spécifiez pas ce paramètre, la configuration des diagnostics est appliquée comme configuration par défaut pour tous les rôles.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Spécifie le nom du service Azure du déploiement.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
Spécifie l’environnement du déploiement à modifier. Les valeurs acceptables pour ce paramètre sont : Production ou Préproduction.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountEndpoint
Spécifie un point de terminaison de compte de stockage.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountKey
Spécifie une clé de compte de stockage.
Type: | String |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Spécifie un nom de compte de stockage.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageContext
Spécifie un contexte de stockage Azure.
Type: | AzureStorageContext |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Spécifie la version de l’extension.
Type: | String |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-X509Certificate
Spécifie un certificat X.509 qui, lorsqu’il est spécifié, est automatiquement chargé sur le service cloud et utilisé pour chiffrer la configuration privée de l’extension.
Type: | X509Certificate2 |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |