Freigeben über


New-AzNotificationHubsNamespace

Erstellt einen Benachrichtigungshub-Namespace.

Syntax

New-AzNotificationHubsNamespace
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-Location] <String>
   [[-Tag] <Hashtable>]
   [[-SkuTier] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzNotificationHubsNamespace erstellt einen Benachrichtigungshub-Namespace. Namespaces sind logische Container, mit denen Sie Ihre Benachrichtigungshubs organisieren und verwalten können. Sie müssen über mindestens einen Benachrichtigungshub-Namespace verfügen. Ein einzelner Namespace kann mehrere Hubs enthalten. Sie können über mehrere Namespaces verfügen, um Ihre Hubs zu organisieren oder bestimmten Personen die Berechtigung zum Verwalten einer ausgewählten Teilmenge Ihrer Hubs zu erteilen. Um einen Namespace zu erstellen, stellen Sie sicher, dass Sie einen eindeutigen Namen für den Namespace angeben. geben Sie das Rechenzentrum an, in dem sich der Namespace befindet; und geben Sie die Ressourcengruppe an, der der Namespace zugewiesen wird. Nachdem der Namespace erstellt wurde, können Sie das Cmdlet New-AzNotificationHubsNamespaceAuthorizationRules verwenden, um diesem Namespace Autorisierungsregeln zuzuweisen. Autorisierungsregeln werden verwendet, um Berechtigungen für den Namespace zu verwalten.

Beispiele

Beispiel 1: Erstellen eines Benachrichtigungshubs

New-AzNotificationHubsNamespace -ResourceGroup "ContosoNotificationsGroup" -Location "West US" -Namespace "ContosoPartners"

Mit diesem Befehl wird ein Benachrichtigungshub namens ContosoPartners erstellt. Der Namespace befindet sich im US-Rechenzentrum "Westen" und wird der Ressourcengruppe "ContosoNotificationsGroup" zugewiesen.

Beispiel 2: Erstellen eines Benachrichtigungshubs mit Tags

New-AzNotificationHubsNamespace -ResourceGroup "ContosoNotificationsGroup" -Location "West US" -Namespace "ContosoPartners" -Tag @{Name="Audience";Value="PartnerOrganizations"}

Mit diesem Befehl wird ein Benachrichtigungshub namens ContosoPartners erstellt. Der Namespace befindet sich im US-Rechenzentrum "Westen" und wird der Ressourcengruppe "ContosoNotificationsGroup" zugewiesen. Darüber hinaus erstellt dieser Befehl ein Tag mit dem Namen "Audience" und dem Wert "PartnerOrganizations" und wird dem Namespace zugewiesen. Dadurch wird sichergestellt, dass der Namespace jedes Mal angezeigt wird, wenn Sie nach Elementen filtern, für die das Audience-Tag auf "PartnerOrganizations" festgelegt ist.

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

-Location

Gibt den Anzeigenamen des Rechenzentrums an, das den Namespace hosten soll. Obwohl Sie diesen Parameter auf einen beliebigen gültigen Speicherort festlegen können, können Sie für eine optimale Leistung ein Rechenzentrum verwenden, das sich in der Nähe der Meisten Ihrer Benutzer befindet.

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

-Namespace

Gibt den Namen des neuen Namespaces an. Namespaces bieten eine Möglichkeit zum Gruppieren und Kategorisieren von Benachrichtigungshubs.

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

-ResourceGroup

Gibt die Ressourcengruppe an, der der Namespace zugewiesen wird. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und -verwaltung unterstützen.

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

-SkuTier

Sku-Ebene des Namespaces

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

-Tag

Gibt Namen-Wert-Paare an, die zum Kategorisieren und Organisieren von Azure-Elementen verwendet werden können. Tags funktionieren ähnlich wie Schlüsselwörter und funktionieren in einer Bereitstellung. Wenn Sie beispielsweise nach allen Elementen mit dem Tag "Abteilung:IT" suchen, gibt die Suche alle Azure-Elemente zurück, die über dieses Tag verfügen, unabhängig von Elementtyp, Standort oder Ressourcengruppe. Ein einzelnes Tag besteht aus zwei Teilen: dem Name und optional dem Value. Beispielsweise lautet der Tagname "Department:IT" "Department:IT" und der Tagwert "IT". Verwenden Sie zum Hinzufügen eines Tags eine Hashtabellensyntax ähnlich wie dies, wodurch das Tag CalendarYear:2016 erstellt wird:

Typ:Hashtable
Position:3
Standardwert:None
Erforderlich:False
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

String

Hashtable

Ausgaben

NamespaceAttributes