New-AzEventGridPartnerTopic

模組:

Az.EventGrid

使用指定的參數，以異步方式建立新的夥伴主題。

語法

New-AzEventGridPartnerTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-ActivationState <String>]
   [-EnableSystemAssignedIdentity]
   [-EventTypeInfoInlineEventType <Hashtable>]
   [-EventTypeInfoKind <String>]
   [-ExpirationTimeIfNotActivatedUtc <DateTime>]
   [-IdentityPrincipalId <String>]
   [-IdentityTenantId <String>]
   [-MessageForActivation <String>]
   [-PartnerRegistrationImmutableId <String>]
   [-PartnerTopicFriendlyDescription <String>]
   [-Source <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <PSObject>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridPartnerTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridPartnerTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzEventGridPartnerTopic
   -InputObject <IEventGridIdentity>
   -Location <String>
   [-ActivationState <String>]
   [-EnableSystemAssignedIdentity]
   [-EventTypeInfoInlineEventType <Hashtable>]
   [-EventTypeInfoKind <String>]
   [-ExpirationTimeIfNotActivatedUtc <DateTime>]
   [-IdentityPrincipalId <String>]
   [-IdentityTenantId <String>]
   [-MessageForActivation <String>]
   [-PartnerRegistrationImmutableId <String>]
   [-PartnerTopicFriendlyDescription <String>]
   [-Source <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <PSObject>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用指定的參數，以異步方式建立新的夥伴主題。

範例

範例 1：以異步方式建立具有指定參數的新夥伴主題。

$partnerRegistration = Get-AzEventGridPartnerRegistration -ResourceGroupName azps_test_group_eventgrid -Name azps-registration
New-AzEventGridPartnerTopic -Name default -ResourceGroupName azps_test_group_eventgrid -Location eastus -partnerRegistrationImmutableId $partnerRegistration.ImmutableId -Source "ContosoCorp.Accounts.User1" -ExpirationTimeIfNotActivatedUtc "2023-11-17T11:06:13.109Z" -PartnerTopicFriendlyDescription "Example description" -MessageForActivation "Example message for activation"

Location Name    ResourceGroupName
-------- ----    -----------------
eastus   default azps_test_group_eventgrid

使用指定的參數，以異步方式建立新的夥伴主題。

參數

-ActivationState

合作夥伴主題的啟用狀態。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableSystemAssignedIdentity

決定是否為資源啟用系統指派的身分識別。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EventTypeInfoInlineEventType

資源的內嵌事件類型集合。 內嵌事件類型索引鍵的類型為字串，代表事件的名稱。有效的內嵌事件名稱範例是 「Contoso.OrderCreated」。。內嵌事件類型值的類型為 InlineEventProperties，且會包含每個內嵌事件類型的其他資訊。

類型:	Hashtable
別名:	InlineEvent
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EventTypeInfoKind

所使用的事件類型類型。

類型:	String
別名:	EventTypeKind
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExpirationTimeIfNotActivatedUtc

合作夥伴主題的到期時間。 如果此定時器在合作夥伴主題仍未啟用時過期，則會刪除夥伴主題和對應的事件通道。

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityPrincipalId

資源識別的主要標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityTenantId

資源的租用戶標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

Identity 參數

類型:	IEventGridIdentity
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-JsonFilePath

提供給建立作業的 Json 檔案路徑

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-JsonString

提供給建立作業的 Json 字串

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Location

資源的位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MessageForActivation

訂閱者在核准程序期間可以使用的內容或實用訊息。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

合作夥伴主題的名稱。

類型:	String
別名:	PartnerTopicName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PartnerRegistrationImmutableId

對應夥伴註冊的不可變標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PartnerTopicFriendlyDescription

關於主題的易記描述。 這可由發行者/合作夥伴設定，以顯示客戶合作夥伴主題的自定義描述。這有助於移除客戶建立合作夥伴主題來源的任何模棱兩可。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

當命令成功時傳回 true

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

用戶訂用帳戶內的資源組名。

類型:	String
別名:	ResourceGroup
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Source

與此合作夥伴主題相關聯的來源。 這代表唯一的夥伴資源。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

資源的標記。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserAssignedIdentity

與資源相關聯的使用者指派身分識別數位。 陣組中的元素會是 ARM 資源標識符，格式為：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。'

類型:	String[]
別名:	IdentityId
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

IEventGridIdentity

輸出

IPartnerTopic