Freigeben über

New-AzNotificationHub

  • Referenz
Modul:
Az.NotificationHubs

Erstellt einen Benachrichtigungshub.

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>]

Beschreibung

Das Cmdlet New-AzNotificationHub erstellt einen Benachrichtigungshub. Benachrichtigungshubs werden verwendet, um Pushbenachrichtigungen unabhängig von der Plattform, die von diesen Clients verwendet wird, an mehrere Clients zu senden. Benachrichtigungshubs entsprechen ungefähr einzelnen Apps: Jede Ihrer Apps verfügt in der Regel über einen eigenen Benachrichtigungshub. Das cmdlet New-AzNotificationHub bietet zwei Möglichkeiten zum Erstellen eines neuen Benachrichtigungshubs. Sie können eine Instanz des NotificationHubAttributes-Objekts erstellen und dann dieses Objekt konfigurieren. Anschließend können Sie diese Eigenschaftswerte über den parameter NotificationHubObj in Ihren neuen Hub kopieren. Alternativ können Sie eine JSON-Datei (JavaScript Object Notation) erstellen, die die relevanten Konfigurationswerte enthält, und diese Werte dann mithilfe des InputFile--Parameters anwenden. Bei Verwendung in Verbindung mit dem Cmdlet New-AzNotificationHub erstellt das vorherige JSON-Beispiel einen Benachrichtigungshub namens ContosoNotificationHub im Us-Rechenzentrum West.

Beispiele

Beispiel 1: Erstellen eines Benachrichtigungshubs

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

Mit diesem Befehl wird ein Benachrichtigungshub im Namespace ContosoNamespace erstellt. Der neue Hub wird der ContosoNotificationsGroup zugewiesen. Sie müssen keinen Namen oder andere Konfigurationsinformationen für den Hub angeben; diese Informationen werden aus der Eingabedatei C:\Configurations\InternalHub.jsentnommen.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputFile

Gibt den Pfad zu einer JSON-Datei an, die Konfigurationswerte für den neuen Benachrichtigungshub enthält.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Namespace

Gibt den Namespace an, dem der Benachrichtigungshub zugewiesen wird. Namespaces bieten eine Möglichkeit zum Gruppieren und Kategorisieren von Benachrichtigungshubs. Benachrichtigungshubs müssen einem vorhandenen Namespace zugewiesen werden. Das Cmdlet New-AzNotificationHub kann keinen neuen Namespace erstellen.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NotificationHubObj

Gibt das NotificationHubAttributes- -Objekt an, das Konfigurationsinformationen für den neuen Hub enthält.

Typ:NotificationHubAttributes
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroup

Gibt die Ressourcengruppe an, der der Benachrichtigungshub zugewiesen wird. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und die Azure-Verwaltung unterstützen. Sie müssen eine vorhandene Ressourcengruppe verwenden. Das Cmdlet New-AzNotificationHub kann keine neue Ressourcengruppe erstellen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben