Freigeben über

Set-AzNotificationHubsNamespace

  • Referenz
Modul:
Az.NotificationHubs

Legt Eigenschaftswerte für einen Benachrichtigungshub-Namespace fest.

Syntax

Set-AzNotificationHubsNamespace
   [-ResourceGroup] <String>
   [-Namespace] <String>
   [-Location] <String>
   [[-State] <NamespaceState>]
   [[-Critical] <Boolean>]
   [[-Tag] <Hashtable>]
   [[-SkuTier] <String>]
   [-Force]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-AzNotificationHubsNamespace legt die Eigenschaftswerte eines vorhandenen Notification Hub-Namespaces fest. Namespaces sind logische Container, mit denen Sie Ihre Benachrichtigungshubs organisieren und verwalten können. Sie müssen über mindestens einen Benachrichtigungshub-Namespace verfügen. Darüber hinaus müssen alle Benachrichtigungshubs über einen zugewiesenen Namespace verfügen. Dieses Cmdlet wird in erster Linie verwendet, um einen Namespace zu aktivieren und zu deaktivieren. Wenn ein Namespace deaktiviert ist, können Benutzer keine Verbindung mit einem der Benachrichtigungshubs im Namespace herstellen, oder Administratoren können diese Hubs zum Senden von Pushbenachrichtigungen verwenden. Um einen deaktivierten Namespace erneut zu aktivieren, verwenden Sie dieses Cmdlet, um die eigenschaft State des Namespaces auf "Aktiv" festzulegen. Sie können dieses Cmdlet auch verwenden, um einen Namespace als kritisch zu kennzeichnen. Dadurch wird verhindert, dass der Namespace gelöscht wird. Um einen kritischen Namespace zu entfernen, müssen Sie zuerst das Kritische Tag entfernen.

Beispiele

Beispiel 1: Deaktivieren eines Namespaces

Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Disabled" -SkuTier "Standard"

Mit diesem Befehl wird der Standardebenennamespace "ContosoPartners" im US-Rechenzentrum "Westen" deaktiviert und der Ressourcengruppe "ContosoNotificationsGroup" zugewiesen.

Beispiel 2: Aktivieren eines Namespace

Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Active" -SkuTier "Standard"

Mit diesem Befehl wird der Standardebenennamespace "ContosoPartners" im US-Rechenzentrum "Westen" aktiviert und der Ressourcengruppe "ContosoNotificationsGroup" zugewiesen.

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

-Critical

Gibt an, ob der Namespace ein kritischer Namespace ist. Kritische Namespaces können nicht gelöscht werden. Um einen kritischen Namespace zu löschen, müssen Sie den Wert dieser Eigenschaft auf "False" festlegen, um den Namespace als nicht kritisch zu markieren.

Typ:Boolean
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-Force

Bitten Sie nicht um Bestätigung.

Typ:SwitchParameter
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 Azure-Standort festlegen können, sollten Sie für eine optimale Leistung ein Rechenzentrum verwenden, das sich in der Nähe der meisten Ihrer Benutzer befindet. Führen Sie den folgenden Befehl aus, um eine up-to-Datumsliste von Azure-Speicherorten abzurufen: Get-AzLocation | Select-Object DisplayName

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

-Namespace

Gibt den Namespace an, den dieses Cmdlet ändert. 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 ist. Ressourcengruppen organisieren Elemente wie Namespaces, Benachrichtigungshubs und Autorisierungsregeln so, dass sie einfach die Bestandsverwaltung und die Azure-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

-State

Gibt den aktuellen Status des Namespaces an. Die zulässigen Werte für diesen Parameter sind: "Aktiv" und "Deaktiviert".

Typ:NamespaceState
Zulässige Werte:Unknown, Active, Disabled
Position:3
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". Um ein Tag hinzuzufügen, verwenden Sie eine Hashtabellensyntax ähnlich wie dies, wodurch das Tag CalendarYear:2016 erstellt wird: -Tags @{Name="CalendarYear"; Value="2016"} Wenn Sie mehrere Tags in demselben Befehl hinzufügen möchten, trennen Sie die einzelnen Tags durch Kommas: -Tag @{Name="CalendarYear"; Value="2016"}, @{Name="FiscalYear"; Value="2017"}

Typ:Hashtable
Position:5
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

NamespaceState

Boolean

Hashtable

Ausgaben

NamespaceAttributes