New-AzEventGridChannel

使用指定的參數同步建立新通道。

語法

CreateExpanded (預設值)

New-AzEventGridChannel
    -Name <String>
    -PartnerNamespaceName <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-ChannelType <String>]
    [-EventTypeInfoInlineEventType <Hashtable>]
    [-EventTypeInfoKind <String>]
    [-ExpirationTimeIfNotActivatedUtc <DateTime>]
    [-MessageForActivation <String>]
    [-PartnerDestinationInfoAzureSubscriptionId <String>]
    [-PartnerDestinationInfoEndpointServiceContext <String>]
    [-PartnerDestinationInfoName <String>]
    [-PartnerDestinationInfoResourceGroupName <String>]
    [-PartnerDestinationInfoResourceMoveChangeHistory <IResourceMoveChangeHistory[]>]
    [-PartnerTopicInfoAzureSubscriptionId <String>]
    [-PartnerTopicInfoName <String>]
    [-PartnerTopicInfoResourceGroupName <String>]
    [-PartnerTopicInfoSource <String>]
    [-ProvisioningState <String>]
    [-ReadinessState <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

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

CreateViaJsonFilePath

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

CreateViaIdentityPartnerNamespaceExpanded

New-AzEventGridChannel
    -Name <String>
    -PartnerNamespaceInputObject <IEventGridIdentity>
    [-ChannelType <String>]
    [-EventTypeInfoInlineEventType <Hashtable>]
    [-EventTypeInfoKind <String>]
    [-ExpirationTimeIfNotActivatedUtc <DateTime>]
    [-MessageForActivation <String>]
    [-PartnerDestinationInfoAzureSubscriptionId <String>]
    [-PartnerDestinationInfoEndpointServiceContext <String>]
    [-PartnerDestinationInfoName <String>]
    [-PartnerDestinationInfoResourceGroupName <String>]
    [-PartnerDestinationInfoResourceMoveChangeHistory <IResourceMoveChangeHistory[]>]
    [-PartnerTopicInfoAzureSubscriptionId <String>]
    [-PartnerTopicInfoName <String>]
    [-PartnerTopicInfoResourceGroupName <String>]
    [-PartnerTopicInfoSource <String>]
    [-ProvisioningState <String>]
    [-ReadinessState <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded

New-AzEventGridChannel
    -InputObject <IEventGridIdentity>
    [-ChannelType <String>]
    [-EventTypeInfoInlineEventType <Hashtable>]
    [-EventTypeInfoKind <String>]
    [-ExpirationTimeIfNotActivatedUtc <DateTime>]
    [-MessageForActivation <String>]
    [-PartnerDestinationInfoAzureSubscriptionId <String>]
    [-PartnerDestinationInfoEndpointServiceContext <String>]
    [-PartnerDestinationInfoName <String>]
    [-PartnerDestinationInfoResourceGroupName <String>]
    [-PartnerDestinationInfoResourceMoveChangeHistory <IResourceMoveChangeHistory[]>]
    [-PartnerTopicInfoAzureSubscriptionId <String>]
    [-PartnerTopicInfoName <String>]
    [-PartnerTopicInfoResourceGroupName <String>]
    [-PartnerTopicInfoSource <String>]
    [-ProvisioningState <String>]
    [-ReadinessState <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

使用指定的參數同步建立新通道。

範例

範例 1:同步建立具有指定參數的新通道。

$dateObj = Get-Date -Year 2023 -Month 11 -Day 10 -Hour 11 -Minute 06 -Second 07
New-AzEventGridChannel -Name azps-channel -PartnerNamespaceName azps-partnernamespace -ResourceGroupName azps_test_group_eventgrid -ChannelType PartnerTopic -PartnerTopicInfoAzureSubscriptionId "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" -PartnerTopicInfoResourceGroupName "azps_test_group_eventgrid2" -PartnerTopicInfoName "default" -PartnerTopicInfoSource "ContosoCorp.Accounts.User1" -ExpirationTimeIfNotActivatedUtc $dateObj.ToUniversalTime()
Name         ResourceGroupName
----         -----------------
azps-channel azps_test_group_eventgrid

同步建立具有指定參數的新通道。

參數

-ChannelType

事件通道的類型,表示事件的方向流程。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:cf

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

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

參數屬性

類型:PSObject
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzureRMContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EventTypeInfoInlineEventType

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

參數屬性

類型:Hashtable
預設值:None
支援萬用字元:False
不要顯示:False
別名:內嵌事件

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EventTypeInfoKind

所使用的事件類型類型。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:事件類型種類

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExpirationTimeIfNotActivatedUtc

通道的到期時間。 如果此計時器到期,而對應的合作夥伴主題從未啟動,則會刪除通道和對應的合作夥伴主題。

參數屬性

類型:DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InputObject

Identity 參數

參數屬性

類型:IEventGridIdentity
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateViaIdentityExpanded
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonFilePath

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-JsonString

提供給建立作業的 Json 字串

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MessageForActivation

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

通道的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:頻道名稱

參數集

CreateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerDestinationInfoAzureSubscriptionId

Azure 訂閱用戶的 ID。 與通道相關聯的合作夥伴目的地將會在此 Azure 訂用帳戶下建立。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerDestinationInfoEndpointServiceContext

合作夥伴目的地端點的其他內容。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerDestinationInfoName

與通道相關聯的夥伴目的地名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerDestinationInfoResourceGroupName

訂閱者的 Azure 資源群組。 與通道相關聯的合作夥伴目的地將會在此資源群組下建立。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerDestinationInfoResourceMoveChangeHistory

變更資源移動的歷程記錄。

參數屬性

類型:

IResourceMoveChangeHistory[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerNamespaceInputObject

Identity 參數

參數屬性

類型:IEventGridIdentity
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerNamespaceName

夥伴命名空間的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerTopicInfoAzureSubscriptionId

Azure 訂閱用戶的 ID。 與通道相關聯的合作夥伴主題將會在此 Azure 訂用帳戶下建立。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerTopicInfoName

與通道相關聯的合作夥伴主題名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:合作夥伴主題名稱

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerTopicInfoResourceGroupName

訂閱者的 Azure 資源群組。 與通道相關聯的合作夥伴主題將會在此資源群組下建立。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartnerTopicInfoSource

發行者會提供來源資訊,以判斷事件的來源範圍或內容。 在建立的合作夥伴主題核准程式期間,訂閱者可以使用這項資訊。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:合作夥伴主題來源

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PassThru

當命令成功時傳回 true

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ProvisioningState

通道的布建狀態。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ReadinessState

對應夥伴主題的整備狀態。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityPartnerNamespaceExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaIdentityExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceGroupName

合作夥伴訂用帳戶內資源群組的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False
別名:資源群組

參數集

CreateExpanded
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonString
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonFilePath
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SubscriptionId

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

參數屬性

類型:String
預設值:(Get-AzContext).Subscription.Id
支援萬用字元:False
不要顯示:False

參數集

CreateExpanded
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonString
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
CreateViaJsonFilePath
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:無線

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

輸入

IEventGridIdentity

輸出

IChannel