New-AzEventHub
네임스페이스 내에서 중첩된 리소스로 새 이벤트 허브를 만듭니다.
구문
New-AzEventHub
-Name <String>
-NamespaceName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-CaptureEnabled]
[-CleanupPolicy <String>]
[-DestinationName <String>]
[-Encoding <String>]
[-IdentityType <String>]
[-IntervalInSeconds <Int32>]
[-MinCompactionLagInMin <Int64>]
[-PartitionCount <Int64>]
[-RetentionTimeInHour <Int64>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-Status <String>]
[-StorageAccountResourceId <String>]
[-TimestampType <String>]
[-TombstoneRetentionTimeInHour <Int32>]
[-UserAssignedIdentityId <String>]
[-UserMetadata <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventHub
-Name <String>
-NamespaceInputObject <IEventHubIdentity>
[-ArchiveNameFormat <String>]
[-BlobContainer <String>]
[-CaptureEnabled]
[-CleanupPolicy <String>]
[-DestinationName <String>]
[-Encoding <String>]
[-IdentityType <String>]
[-IntervalInSeconds <Int32>]
[-MinCompactionLagInMin <Int64>]
[-PartitionCount <Int64>]
[-RetentionTimeInHour <Int64>]
[-SizeLimitInBytes <Int32>]
[-SkipEmptyArchive]
[-Status <String>]
[-StorageAccountResourceId <String>]
[-TimestampType <String>]
[-TombstoneRetentionTimeInHour <Int32>]
[-UserAssignedIdentityId <String>]
[-UserMetadata <String>]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventHub
-Name <String>
-NamespaceInputObject <IEventHubIdentity>
-Parameter <IEventhub>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
네임스페이스 내에서 중첩된 리소스로 새 이벤트 허브를 만듭니다.
예제
예제 1: EventHub 엔터티 만들기
New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -RetentionTimeInHour 168 -PartitionCount 5 -CleanupPolicy Delete
ArchiveNameFormat :
BlobContainer :
CaptureEnabled :
CleanupPolicy : Delete
CreatedAt : 4/25/2023 3:55:45 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding :
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds :
Location : eastus
MessageRetentionInDay : 7
Name : myEventHub
PartitionCount : 5
PartitionId : {0, 1, 2, 3�}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 168
SizeLimitInBytes :
SkipEmptyArchive :
Status : Active
StorageAccountResourceId :
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 4/25/2023 3:55:46 AMCleaupPolicy Delete사용하여 네임스페이스 myNamespace 새 eventhub 엔터티 myEventHub 만듭니다.
예제 2: 캡처를 사용하도록 설정된 EventHub 만들기
New-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 -CleanupPolicy Delete"
ArchiveNameFormat : {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}
BlobContainer : container
CaptureEnabled : true
CreatedAt : 9/1/2022 5:55:46 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding : Avro
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myFirstEventHub
IntervalInSeconds : 600
Location : centralus
MessageRetentionInDays : 6
Name : myFirstEventHub
PartitionCount : 5
PartitionId : {0}
ResourceGroupName : myResourceGroup
RetentionTimeInHour : 24
SizeLimitInBytes : 11000000
SkipEmptyArchive : true
Status : Active캡처를 사용하도록 설정된 네임스페이스 myNamespace 새 eventhub 엔터티 myEventHub 만듭니다.
예제 3: EventHub 엔터티 만들기
New-AzEventHub -Name myEventHub -ResourceGroupName myResourceGroup -NamespaceName myNamespace -CleanupPolicy Compact
ArchiveNameFormat :
BlobContainer :
CaptureEnabled :
CleanupPolicy : Compact
CreatedAt : 4/25/2023 4:05:57 AM
DataLakeAccountName :
DataLakeFolderPath :
DataLakeSubscriptionId :
DestinationName :
Encoding :
Id : /subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myNamespace/eventhubs/myEventHub
IntervalInSeconds :
Location : eastus
MessageRetentionInDay : 9223372036854775807
Name : myEventHub
PartitionCount : 4
PartitionId : {0, 1, 2, 3}
ResourceGroupName : myResourceGroup
RetentionTimeInHour :
SizeLimitInBytes :
SkipEmptyArchive :
Status : Active
StorageAccountResourceId :
SystemDataCreatedAt :
SystemDataCreatedBy :
SystemDataCreatedByType :
SystemDataLastModifiedAt :
SystemDataLastModifiedBy :
SystemDataLastModifiedByType :
TombstoneRetentionTimeInHour :
Type : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt : 4/25/2023 4:05:58 AMCleaupPolicy Compact사용하여 네임스페이스 myNamespace 새 eventhub 엔터티 myEventHub 만듭니다.
매개 변수
-ArchiveNameFormat
보관에 대한 Blob 명명 규칙(예: {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}) 여기서 모든 매개 변수(네임스페이스, EventHub 등)는 순서에 관계없이 필수입니다.
| 형식: | String |
| 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 |
-CleanupPolicy
정리 정책에 사용할 수 있는 값을 열거합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.
| 형식: | 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
Azure Active Directory 관리 ID의 유형입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IntervalInSeconds
시간 창을 사용하면 Azure Blob에 대한 캡처가 발생하는 빈도를 설정할 수 있습니다. 값은 60~900초 사이여야 합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MinCompactionLagInMin
로그에서 메시지를 압축할 수 없는 최소 시간입니다. 이 값은 cleanupPolicy가 Compact 또는 DeleteOrCompact일 때 사용됩니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
이벤트 허브 이름
| 형식: | String |
| 별칭: | EventHubName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NamespaceInputObject
ID 매개 변수
| 형식: | IEventHubIdentity |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-NamespaceName
네임스페이스 이름
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Parameter
목록 또는 이벤트 허브 가져오기 작업의 단일 항목
| 형식: | IEventhub |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PartitionCount
이벤트 허브에 대해 생성된 파티션 수, 허용되는 값은 1~32개 파티션입니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ResourceGroupName
Azure 구독 내의 리소스 그룹의 이름입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RetentionTimeInHour
이 이벤트 허브에 대한 이벤트를 보존하는 데 소요되는 시간입니다. 이 값은 최대 네임스페이스 SKU 최대값이어야 합니다. -1 보존 시간이 무한하지만 엔터티의 크기가 제한되고 크기가 네임스페이스 SKU 형식에 따라 달라지는 특별한 경우입니다.
| 형식: | 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
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.
| 형식: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimestampType
메시지가 저장할 타임스탬프의 유형을 나타냅니다. "AppendTime" 및 "CreateTime"의 두 가지 타임스탬프 형식입니다. AppendTime은 Broker 로그 내에 메시지가 추가된 시간을 나타냅니다. CreateTime은 원본 쪽에서 메시지가 생성된 시간을 의미하며 생산자는 메시지를 보내는 동안 이 타임스탬프를 설정할 수 있습니다. 기본값은 AppendTime입니다. AMQP 프로토콜을 사용하는 경우 CreateTime은 AppendTime과 같으며 해당 동작은 동일하게 유지됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TombstoneRetentionTimeInHour
압축된 이벤트 허브의 삭제 표시 표식을 유지하는 데 소요되는 시간입니다. 이 값은 cleanupPolicy가 Compact 또는 DeleteOrCompact일 때 사용됩니다. 소비자는 압축된 이벤트 허브 내의 삭제 표시 표식에 의해 설명된 특정 키에 대한 유효한 스냅샷을 가져오기 위해 시작 오프셋에서 시작하는 경우 지정된 시간 내에 삭제 표시 표식 읽기를 완료해야 합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserAssignedIdentityId
관리되는 사용자 ID의 ARM ID입니다. 이 속성은 UserAssignedIdentity 형식이 필요합니다. SystemAssigned 형식인 경우 네임스페이스와 연결된 시스템 할당 ID가 사용됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserMetadata
사용자의 메타데이터를 가져오고 설정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
출력
Azure PowerShell