Set-AzEventHub
EventHub 엔터티 업데이트
구문
Set-AzEventHub
-Name <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-CaptureEnabled]
[-Encoding <String>]
[-IntervalInSeconds <Int32>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-RetentionTimeInHour <Int64>]
[-TombstoneRetentionTimeInHour <Int32>]
[-Status <String>]
[-DestinationName <String>]
[-IdentityType <String>]
[-UserAssignedIdentityId <String>]
[-PartitionCount <Int64>]
[-StorageAccountResourceId <String>]
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzEventHub
-InputObject <IEventHubIdentity>
[-CaptureEnabled]
[-Encoding <String>]
[-IntervalInSeconds <Int32>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-RetentionTimeInHour <Int64>]
[-TombstoneRetentionTimeInHour <Int32>]
[-Status <String>]
[-DestinationName <String>]
[-IdentityType <String>]
[-UserAssignedIdentityId <String>]
[-PartitionCount <Int64>]
[-StorageAccountResourceId <String>]
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
EventHub 엔터티 업데이트
예제
예제 1: 기존 EventHub 엔터티에 캡처 설정
Set-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -ArchiveNameFormat "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}" -BlobContainer container -CaptureEnabled -DestinationName EventHubArchive.AzureBlockBlob -Encoding Avro -IntervalInSeconds 600 -SizeLimitInBytes 11000000 -SkipEmptyArchive -StorageAccountResourceId "/subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount"
ArchiveNameFormat : {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}
BlobContainer : container
CaptureEnabled : True
CleanupPolicy : Delete
CreatedAt : 1/1/0001 12:00:00 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName : EventHubArchive.AzureBlockBlob
Encoding : Avro
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/namespace3/eventhubs/myEventHub
IntervalInSeconds : 600
Location : eastus
MessageRetentionInDay : 7
Name : myEventHub
PartitionCount : 5
PartitionId : {}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 168
SizeLimitInBytes : 11000000
SkipEmptyArchive : True
Status : Active
StorageAccountResourceId : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 1/1/0001 12:00:00 AM
네임스페 myNamespace
이스에서 EventHub 엔터티 myEventHub
를 업데이트하여 캡처를 사용하도록 설정합니다.
예제 2: InputObject 매개 변수 집합을 사용하여 EventHub EventHub 엔터티 업데이트
$eventhub = Get-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace
Set-AzEventHub -InputObject $eventhub -RetentionTimeInHour 72
ArchiveNameFormat : {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}
BlobContainer : container1entHub]>
CaptureEnabled : True
CleanupPolicy : Delete
CreatedAt : 1/1/0001 12:00:00 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName : EventHubArchive.AzureBlockBlob
Encoding : Avro
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds : 600
Location : eastus
MessageRetentionInDay : 3
Name : myEventHub
PartitionCount : 5
PartitionId : {}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 72
SizeLimitInBytes : 11000000
SkipEmptyArchive : True
Status : Active
StorageAccountResourceId : /subscriptions/subscriptionId/resourceGroups/myResourcegroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount
1
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 1/1/0001 12:00:00 AM
RetentionTimeInHour
EventHub 엔터티 myEventHub
에서 72시간으로 업데이트됩니다.
매개 변수
-ArchiveNameFormat
보관에 대한 Blob 명명 규칙(예: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}) 여기서 모든 매개 변수(Namespace, EventHub 등)는 순서에 관계없이 필수입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AsJob
작업으로 명령 실행
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BlobContainer
Blob 컨테이너 이름
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CaptureEnabled
캡처 설명을 사용할 수 있는지 여부를 나타내는 값입니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
형식: | PSObject |
별칭: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DestinationName
캡처 대상의 이름
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Encoding
캡처 설명의 인코딩 형식에 사용할 수 있는 값을 열거합니다. 참고: 'AvroDeflate'는 새 API 버전에서 더 이상 사용되지 않습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IdentityType
관리 서비스 ID의 유형입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-InputObject
ID 매개 변수입니다. 생성하려면 INPUTOBJECT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.
형식: | IEventHubIdentity |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-IntervalInSeconds
시간 창을 사용하면 Azure Blob에 대한 캡처가 발생하는 빈도를 설정할 수 있습니다. 값은 60~900초 사이여야 합니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Name
EventHub 엔터티의 이름입니다.
형식: | String |
별칭: | EventHubName |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-NamespaceName
EventHub 네임스페이스의 이름입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-NoWait
명령을 비동기적으로 실행
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PartitionCount
이벤트 허브에 대해 생성된 파티션 수입니다. 허용되는 값은 1~32개의 파티션입니다.
형식: | Int64 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceGroupName
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RetentionTimeInHour
이 이벤트 허브에 대한 이벤트를 보존하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Delete인 경우에만 사용됩니다. cleanupPolicy가 Compaction이면 이 속성의 반환 값이 Long.MaxValue입니다.
형식: | Int64 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SizeLimitInBytes
크기 창은 캡처 작업 전에 Event Hub에 빌드된 데이터의 양을 정의합니다. 값은 10485760 바이트에서 524288000 바이트 사이여야 합니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SkipEmptyArchive
빈 보관 파일을 건너뛸지 여부를 나타내는 값입니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Status
이벤트 허브의 상태에 대해 가능한 값을 열거합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-StorageAccountResourceId
Blob을 만드는 데 사용할 스토리지 계정의 리소스 ID
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SubscriptionId
대상 구독의 ID입니다.
형식: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TombstoneRetentionTimeInHour
압축된 이벤트 허브의 삭제 표시 표식을 유지하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Compaction인 경우에만 사용됩니다. 소비자는 압축된 이벤트 허브 내의 삭제 표시 표식에 의해 설명된 특정 키에 대한 유효한 스냅샷을 가져오기 위해 시작 오프셋에서 시작하는 경우 지정된 시간 내에 삭제 표시 표식 읽기를 완료해야 합니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UserAssignedIdentityId
사용자 할당 ID에 대한 속성
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
출력
Azure PowerShell