Compartir a través de

Set-AzureServiceDiagnosticsExtension

  • Referencia
Módulo:
Azure

Habilita la extensión de Azure Diagnostics en roles especificados o en todos los roles de un servicio implementado o en la implementación.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Importante

Cloud Services (clásico) ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024 para todos los clientes. Las nuevas implementaciones deben utilizar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido) .

Sintaxis

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

El cmdlet Set-AzureServiceDiagnosticsExtension habilita la extensión de Azure Diagnostics en roles especificados o en todos los roles de un servicio implementado o en la implementación.

Ejemplos

Ejemplo 1: Habilitación de la extensión azure Diagnostics

PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML

Este comando habilita la extensión Azure Diagnostics para todos los roles.

Ejemplo 2: Habilitación de la extensión de Azure Diagnostics para un rol especificado

PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML -Role "WebRole01"

Este comando habilita la extensión azure Diagnostics para un rol especificado.

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.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiagnosticsConfiguration

Especifica una matriz de configuración para Azure Diagnostics.

Tipo:ExtensionConfigurationInput[]
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DiagnosticsConfigurationPath

Especifica la configuración de Azure Diagnostics. Puede descargar el esquema mediante el siguiente comando:

(Get-AzureServiceAvailableExtension -ExtensionName 'PaaSDiagnostics' -ProviderNamespace 'Microsoft.Azure.Diagnostics').PublicConfigurationSchema | Out-File -Encoding utf8 -FilePath 'WadConfig.xsd'

Tipo:String
Posición:9
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ExtensionId

Especifica el identificador de extensión.

Tipo:String
Posición:11
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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
  • Detención
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

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

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Role

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

Tipo:String[]
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServiceName

Especifica el nombre del servicio de Azure de la implementación.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Slot

Especifica el entorno de la implementación que se va a modificar. Los valores aceptables para este parámetro son: Producción o ensayo.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountEndpoint

Especifica un punto de conexión de cuenta de almacenamiento.

Tipo:String
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountKey

Especifica una clave de cuenta de almacenamiento.

Tipo:String
Posición:6
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountName

Especifica un nombre de cuenta de almacenamiento.

Tipo:String
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageContext

Especifica un contexto de almacenamiento de Azure.

Tipo:AzureStorageContext
Posición:8
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Version

Especifica la versión de la extensión.

Tipo:String
Posición:10
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-X509Certificate

Especifica un certificado X.509 que, cuando se especifica, se carga automáticamente en el servicio en la nube y se usa para cifrar la configuración privada de la extensión.

Tipo:X509Certificate2
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False