Delen via

Set-AzureServiceDiagnosticsExtension

  • Referentie
Module:
Azure

Hiermee schakelt u de Azure Diagnostics-extensie in voor opgegeven rollen of alle rollen in een geïmplementeerde service of bij de implementatie.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Belangrijk

Cloud Services (klassiek) is nu afgeschaft voor nieuwe klanten en wordt op 31 augustus 2024 buiten gebruik gesteld voor alle klanten. Nieuwe implementaties moeten gebruikmaken van het nieuwe op Azure Resource Manager gebaseerde implementatiemodel Azure Cloud Services (uitgebreide ondersteuning).

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

Met de cmdlet Set-AzureServiceDiagnosticsExtension schakelt u de Azure Diagnostics-extensie in voor opgegeven rollen of alle rollen in een geïmplementeerde service of bij de implementatie.

Voorbeelden

Voorbeeld 1: Azure Diagnostics-extensie inschakelen

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

Met deze opdracht wordt de Azure Diagnostics-extensie ingeschakeld voor alle rollen.

Voorbeeld 2: Azure Diagnostics-extensie inschakelen voor een opgegeven rol

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

Met deze opdracht wordt de Azure Diagnostics-extensie ingeschakeld voor een opgegeven rol.

Parameters

-CertificateThumbprint

Hiermee geeft u een certificaatvingerafdruk op die moet worden gebruikt om de persoonlijke configuratie te versleutelen. Dit certificaat moet al aanwezig zijn in het certificaatarchief. Als u geen certificaat opgeeft, maakt deze cmdlet een certificaat.

Type:String
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DiagnosticsConfiguration

Hiermee geeft u een matrix van configuratie voor Azure Diagnostics.

Type:ExtensionConfigurationInput[]
Position:2
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-DiagnosticsConfigurationPath

Hiermee geeft u de configuratie voor Azure Diagnostics. U kunt het schema downloaden met behulp van de volgende opdracht:

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

Type:String
Position:9
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-ExtensionId

Hiermee geeft u de extensie-id

Type:String
Position:11
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliases:infa
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliases:iv
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

Hiermee geeft u een optionele matrix met rollen op waarvoor de configuratie van Azure Diagnostics moet worden opgegeven. Als u deze parameter niet opgeeft, wordt de diagnostische configuratie toegepast als de standaardconfiguratie voor alle rollen.

Type:String[]
Position:2
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ServiceName

Hiermee geeft u de Azure-servicenaam van de implementatie op.

Type:String
Position:0
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Slot

Hiermee geeft u de omgeving van de implementatie die moet worden gewijzigd. De acceptabele waarden voor deze parameter zijn: Productie of Fasering.

Type:String
Position:1
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountEndpoint

Hiermee geeft u een eindpunt voor een opslagaccount op.

Type:String
Position:7
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

Hiermee geeft u een opslagaccountsleutel op.

Type:String
Position:6
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Hiermee geeft u een naam voor het opslagaccount op.

Type:String
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageContext

Hiermee geeft u een Azure-opslagcontext op.

Type:AzureStorageContext
Position:8
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ThumbprintAlgorithm

Hiermee geeft u een hash-algoritme voor vingerafdruk op dat wordt gebruikt met de vingerafdruk om het certificaat te identificeren. Deze parameter is optioneel en de standaardwaarde is sha1.

Type:String
Position:4
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Hiermee geeft u de versie van de extensie.

Type:String
Position:10
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-X509Certificate

Hiermee geeft u een X.509-certificaat op dat, wanneer opgegeven, automatisch wordt geüpload naar de cloudservice en wordt gebruikt voor het versleutelen van de persoonlijke configuratie van de extensie.

Type:X509Certificate2
Position:3
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False