Set-AzNotificationHubsNamespace
設定通知中樞命名空間的屬性值。
Syntax
Set-AzNotificationHubsNamespace
[-ResourceGroup] <String>
[-Namespace] <String>
[-Location] <String>
[[-State] <NamespaceState>]
[[-Critical] <Boolean>]
[[-Tag] <Hashtable>]
[[-SkuTier] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzNotificationHubsNamespace Cmdlet 會設定現有通知中樞命名空間的屬性值。 命名空間是邏輯容器,可協助您組織和管理通知中樞。 您必須至少有一個通知中樞命名空間。 此外,所有通知中樞都必須有指派的命名空間。 此 Cmdlet 主要用於啟用和停用命名空間。 停用命名空間時,用戶無法連線到命名空間中的任何通知中樞,系統管理員也無法使用這些中樞來傳送推播通知。 若要重新啟用已停用的命名空間,請使用此 Cmdlet 將命名空間的 State 屬性設定為 Active。 您也可以使用此 Cmdlet 將命名空間標記為重要。 這可防止刪除命名空間。 若要移除重要命名空間,您必須先移除 Critical 標籤。
範例
範例 1:停用命名空間
Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Disabled" -SkuTier "Standard"
此命令會停用位於美國西部數據中心的 ContosoPartners 標準層命名空間,並指派給 ContosoNotificationsGroup 資源群組。
範例 2:啟用命名空間
Set-AzNotificationHubsNamespace -Namespace "ContosoPartners" -Location "West US" -ResourceGroup "ContosoNotificationsGroup" -State "Active" -SkuTier "Standard"
此命令會啟用位於美國西部數據中心的 ContosoPartners 標準層命名空間,並指派給 ContosoNotificationsGroup 資源群組。
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Critical
指出命名空間是否為重要命名空間。 無法刪除重要命名空間。 若要刪除重要命名空間,您必須將此屬性的值設定為 False,才能將命名空間標示為非重大。
Type: | Boolean |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
-Force
請勿要求確認。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
指定裝載命名空間之資料中心的顯示名稱。
雖然您可以將此參數設定為任何有效的 Azure 位置,但為了達到最佳效能,您應該使用位於大部分使用者附近的數據中心。
若要取得 Azure 位置的最新清單,請執行下列命令: Get-AzLocation | Select-Object DisplayName
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Namespace
指定這個 Cmdlet 修改的命名空間。 命名空間提供分組和分類通知中樞的方式。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroup
指定指派命名空間的資源群組。 資源群組會以協助清查管理和 Azure 系統管理的方式,組織命名空間、通知中樞和授權規則等專案。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkuTier
命名空間的Sku層
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-State
指定命名空間的目前狀態。 此參數可接受的值為:Active 和 Disabled。
Type: | NamespaceState |
Accepted values: | Unknown, Active, Disabled |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
指定可用來分類及組織 Azure 專案的名稱/值組。 標記函式類似於關鍵詞,並跨部署運作。 例如,如果您搜尋具有 Department:IT 標籤的所有專案,則搜尋會傳回具有該標籤的所有 Azure 專案,而不論專案類型、位置或資源群組等項目為何。 個別標記包含兩個部分: Name 和 (選擇性) Value。 例如,在 Department:IT 中,標籤稱為 Department,而標籤為 IT。 若要新增標籤,請使用與此類似的哈希表語法,這會建立 CalendarYear:2016: -Tags @{Name=“CalendarYear”;Value=“2016”} 若要在相同的命令中新增多個標記,請使用逗號分隔個別標籤:-Tag @{Name=“CalendarYear”;Value=“2016”}, @{Name=“FiscalYear”;Value=“2017”}
Type: | Hashtable |
Position: | 5 |
Default value: | None |
Required: | False |
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 |