Set-AzureServiceDiagnosticsExtension

Modul:

Azure

Povolí rozšíření Azure Diagnostics pro zadané role nebo všechny role v nasazené službě nebo v nasazení.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Důležité

Služba Cloud Services (Classic) je teď pro nové zákazníky zastaralá a bude vyřazena 31. srpna 2024 pro všechny zákazníky. Nová nasazení by měla používat nový model nasazení založený na Azure Resource Manageru na Azure Cloud Services (rozšířená podpora).

Syntaxe

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

Rutina Set-AzureServiceDiagnosticsExtension umožňuje rozšíření Azure Diagnostics pro zadané role nebo všechny role v nasazené službě nebo v nasazení.

Příklady

Příklad 1: Povolení rozšíření Azure Diagnostics

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

Tento příkaz povolí rozšíření Azure Diagnostics pro všechny role.

Příklad 2: Povolení rozšíření Azure Diagnostics pro zadanou roli

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

Tento příkaz povolí rozšíření Azure Diagnostics pro zadanou roli.

Parametry

-CertificateThumbprint

Určuje kryptografický otisk certifikátu, který se má použít k šifrování privátní konfigurace. Tento certifikát už musí existovat v úložišti certifikátů. Pokud nezadáte certifikát, tato rutina vytvoří certifikát.

Typ:	String
Position:	3
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DiagnosticsConfiguration

Určuje pole konfigurace pro Azure Diagnostics.

Typ:	ExtensionConfigurationInput[]
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DiagnosticsConfigurationPath

Určuje konfiguraci diagnostiky Azure. Schéma si můžete stáhnout pomocí následujícího příkazu:

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

Typ:	String
Position:	9
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ExtensionId

Určuje ID rozšíření.

Typ:	String
Position:	11
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

• Pokračovat
• Ignorovat
• Informovat se
• SilentlyContinue
• Zastavit
• Suspend

Typ:	ActionPreference
Aliasy:	infa
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InformationVariable

Určuje informační proměnnou.

Typ:	String
Aliasy:	iv
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

Typ:	AzureSMProfile
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Role

Určuje volitelnou matici rolí, pro které se má zadat konfigurace azure Diagnostics. Pokud tento parametr nezadáte, použije se konfigurace diagnostiky jako výchozí konfigurace pro všechny role.

Typ:	String[]
Position:	2
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ServiceName

Určuje název služby Azure nasazení.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Slot

Určuje prostředí nasazení, které se má upravit. Přijatelné hodnoty pro tento parametr jsou: Production nebo Staging.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountEndpoint

Určuje koncový bod účtu úložiště.

Typ:	String
Position:	7
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountKey

Určuje klíč účtu úložiště.

Typ:	String
Position:	6
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountName

Určuje název účtu úložiště.

Typ:	String
Position:	5
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageContext

Určuje kontext úložiště Azure.

Typ:	AzureStorageContext
Position:	8
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ThumbprintAlgorithm

Určuje algoritmus hash kryptografického otisku, který se používá s kryptografickým otiskem k identifikaci certifikátu. Tento parametr je volitelný a výchozí hodnota je sha1.

Typ:	String
Position:	4
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Version

Určuje verzi rozšíření.

Typ:	String
Position:	10
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-X509Certificate

Určuje certifikát X.509, který se po zadání automaticky nahraje do cloudové služby a použije se k šifrování privátní konfigurace rozšíření.

Typ:	X509Certificate2
Position:	3
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

Související odkazy

• Get-AzureServiceDiagnosticsExtension
• Remove-AzureServiceDiagnosticsExtension