Set-AzureServiceDiagnosticsExtension
배포된 서비스 또는 배포 시 지정된 역할 또는 모든 역할에 대해 Azure Diagnostics 확장을 사용하도록 설정합니다.
참고 항목
이 설명서에서 참조되는 cmdlet은 ASM(Azure Service Manager) API를 사용하는 레거시 Azure 리소스를 관리하기 위한 것입니다. 이 레거시 PowerShell 모듈은 ASM이 사용 중지될 예정이므로 새 리소스를 만들 때 권장되지 않습니다. 자세한 내용은 Azure Service Manager 사용 중지를 참조 하세요.
Az PowerShell 모듈은 PowerShell을 사용하여 ARM(Azure Resource Manager) 리소스를 관리하는 데 권장되는 PowerShell 모듈입니다.
Important
신규 고객에게는 Cloud Services(클래식)가 사용되지 않으며 모든 고객에 대해 2024년 8월 31일에 사용 중지됩니다. 새 배포에서는 새로운 Azure Resource Manager 기반 배포 모델인 Azure Cloud Services(추가 지원)를 사용해야 합니다.
구문
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
Set-AzureServiceDiagnosticsExtension cmdlet을 사용하면 배포된 서비스 또는 배포 시 지정된 역할 또는 모든 역할에 대한 Azure Diagnostics 확장을 사용할 수 있습니다.
예제
예제 1: Azure Diagnostics 확장 사용
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML이 명령은 모든 역할에 대해 Azure Diagnostics 확장을 사용하도록 설정합니다.
예제 2: 지정된 역할에 Azure Diagnostics 확장 사용
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML -Role "WebRole01"이 명령은 지정된 역할에 대해 Azure Diagnostics 확장을 사용하도록 설정합니다.
매개 변수
-CertificateThumbprint
프라이빗 구성을 암호화하는 데 사용할 인증서 지문을 지정합니다. 이 인증서는 인증서 저장소에 이미 있어야 합니다. 인증서를 지정하지 않으면 이 cmdlet은 인증서를 만듭니다.
| 형식: | String |
| Position: | 3 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DiagnosticsConfiguration
Azure Diagnostics에 대한 구성 배열을 지정합니다.
| 형식: | ExtensionConfigurationInput[] |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DiagnosticsConfigurationPath
Azure Diagnostics에 대한 구성을 지정합니다. 다음 명령을 사용하여 스키마를 다운로드할 수 있습니다.
(Get-AzureServiceAvailableExtension -ExtensionName 'PaaSDiagnostics' -ProviderNamespace 'Microsoft.Azure.Diagnostics').PublicConfigurationSchema | Out-File -Encoding utf8 -FilePath 'WadConfig.xsd'
| 형식: | String |
| Position: | 9 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ExtensionId
확장 ID를 지정합니다.
| 형식: | String |
| Position: | 11 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-InformationAction
이 cmdlet이 정보 이벤트에 응답하는 방법을 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- 계속
- 무시
- 묻다
- SilentlyContinue
- 중지
- 일시 중단됨
| 형식: | ActionPreference |
| 별칭: | infa |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InformationVariable
정보 변수를 지정합니다.
| 형식: | String |
| 별칭: | iv |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Profile
이 cmdlet이 읽는 Azure 프로필을 지정합니다. 프로필을 지정하지 않으면 이 cmdlet은 로컬 기본 프로필에서 읽습니다.
| 형식: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Role
Azure Diagnostics 구성을 지정할 역할의 선택적 배열을 지정합니다. 이 매개 변수를 지정하지 않으면 진단 구성이 모든 역할에 대한 기본 구성으로 적용됩니다.
| 형식: | String[] |
| Position: | 2 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ServiceName
배포의 Azure 서비스 이름을 지정합니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Slot
수정할 배포 환경을 지정합니다. 이 매개 변수에 허용되는 값은 프로덕션 또는 스테이징입니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageAccountEndpoint
스토리지 계정 엔드포인트를 지정합니다.
| 형식: | String |
| Position: | 7 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageAccountKey
스토리지 계정 키를 지정합니다.
| 형식: | String |
| Position: | 6 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageAccountName
스토리지 계정 이름을 지정합니다.
| 형식: | String |
| Position: | 5 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageContext
Azure Storage 컨텍스트를 지정합니다.
| 형식: | AzureStorageContext |
| Position: | 8 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ThumbprintAlgorithm
지문과 함께 인증서를 식별하는 데 사용되는 지문 해시 알고리즘을 지정합니다. 이 매개 변수는 선택 사항이며 기본값은 sha1입니다.
| 형식: | String |
| Position: | 4 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Version
확장의 버전을 지정합니다.
| 형식: | String |
| Position: | 10 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-X509Certificate
지정된 경우 클라우드 서비스에 자동으로 업로드되고 확장 프라이빗 구성을 암호화하는 데 사용되는 X.509 인증서를 지정합니다.
| 형식: | X509Certificate2 |
| Position: | 3 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |