Dela via


Set-AzureServiceDiagnosticsExtension

Aktiverar Azure Diagnostics-tillägget för angivna roller eller alla roller i en distribuerad tjänst eller vid distribution.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med PowerShell.

Viktigt!

Cloud Services (klassisk) är nu inaktuellt för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).

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

Cmdleten Set-AzureServiceDiagnosticsExtension aktiverar Azure Diagnostics-tillägget för angivna roller eller alla roller i en distribuerad tjänst eller vid distribution.

Exempel

Exempel 1: Aktivera Azure Diagnostics-tillägget

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

Det här kommandot aktiverar Azure Diagnostics-tillägget för alla roller.

Exempel 2: Aktivera Azure Diagnostics-tillägget för en angiven roll

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

Det här kommandot aktiverar Azure Diagnostics-tillägget för en angiven roll.

Parametrar

-CertificateThumbprint

Anger ett tumavtryck för certifikat som ska användas för att kryptera den privata konfigurationen. Certifikatet måste redan finnas i certifikatarkivet. Om du inte anger något certifikat skapar den här cmdleten ett certifikat.

Typ:String
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DiagnosticsConfiguration

Anger en konfigurationsmatris för Azure Diagnostics.

Typ:ExtensionConfigurationInput[]
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DiagnosticsConfigurationPath

Anger konfigurationen för Azure Diagnostics. Du kan ladda ned schemat med hjälp av följande kommando:

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

Typ:String
Position:9
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ExtensionId

Anger tilläggs-ID

Typ:String
Position:11
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Alias:infa
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Alias:iv
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Role

Anger en valfri matris med roller som du vill ange Azure Diagnostics-konfigurationen för. Om du inte anger den här parametern tillämpas diagnostikkonfigurationen som standardkonfiguration för alla roller.

Typ:String[]
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServiceName

Anger Azure-tjänstnamnet för distributionen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Slot

Anger den miljö för distributionen som ska ändras. De godtagbara värdena för den här parametern är: Produktion eller mellanlagring.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountEndpoint

Anger en slutpunkt för lagringskontot.

Typ:String
Position:7
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountKey

Anger en lagringskontonyckel.

Typ:String
Position:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountName

Anger ett lagringskontonamn.

Typ:String
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageContext

Anger en Azure Storage-kontext.

Typ:AzureStorageContext
Position:8
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ThumbprintAlgorithm

Anger en tumavtryckshashalgoritm som används med tumavtrycket för att identifiera certifikatet. Den här parametern är valfri och standardvärdet är sha1.

Typ:String
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Version

Anger versionen av tillägget.

Typ:String
Position:10
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-X509Certificate

Anger ett X.509-certifikat som, när det anges, automatiskt laddas upp till molntjänsten och används för att kryptera tilläggets privata konfiguration.

Typ:X509Certificate2
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False