Share via


New-AzNotificationHub

建立通知中樞。

Syntax

New-AzNotificationHub
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-InputFile] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzNotificationHub
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-NotificationHubObj] <NotificationHubAttributes>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzNotificationHub Cmdlet 會建立通知中樞。 通知中樞可用來將推播通知傳送至多個用戶端,而不論這些用戶端所使用的平台為何。 通知中樞大致相當於個別應用程式:每個應用程式通常會有自己的通知中樞。 New-AzNotificationHub Cmdlet 提供兩種方式來建立新的通知中樞。 您可以建立 NotificationHubAttributes 對象的實例,然後設定該物件。 然後,您可以透過 NotificationHubObj 參數,將這些屬性值複製到新的中樞。 或者,您可以建立包含相關組態值的 JSON(JavaScript 物件表示法)檔案,然後使用 InputFile 參數套用這些值。 與 New-AzNotificationHub Cmdlet 搭配使用時,上述 JSON 範例會建立位於美國西部數據中心的 ContosoNotificationHub 名為 ContosoNotificationHub 的通知中樞。

範例

範例 1:建立通知中樞

New-AzNotificationHub -Namespace "ContosoNamespace" -ResourceGroup "ContosoNotificationsGroup" -InputFile "C:\Configurations\InternalHub.json"

此命令會在命名空間 ContosoNamespace 中建立通知中樞。 新的中樞將會指派給 ContosoNotificationsGroup。 您不需要指定中樞的名稱或任何其他組態資訊;該資訊會取自輸入檔 C:\Configurations\InternalHub.json。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputFile

指定 JSON 檔案的路徑,其中包含新通知中樞的組態值。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

指定要指派通知中樞的命名空間。 命名空間提供分組和分類通知中樞的方式。 通知中樞必須指派給現有的命名空間。 New-AzNotificationHub Cmdlet 無法建立新的命名空間。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NotificationHubObj

指定 NotificationHubAttributes 物件,其中包含新中樞的組態資訊。

Type:NotificationHubAttributes
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroup

指定要指派通知中樞的資源群組。 資源群組會以協助清查管理和 Azure 系統管理的方式,組織命名空間、通知中樞和授權規則等專案。 您必須使用現有的資源群組。 New-AzNotificationHub Cmdlet 無法建立新的資源群組。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

輸出

NotificationHubAttributes