New-AzNetworkCloudCluster

參考

模組:: Az.NetworkCloud

如果叢集存在，請建立新的叢集或更新叢集的屬性。

語法

New-AzNetworkCloudCluster
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -AggregatorOrSingleRackDefinitionNetworkRackId <String>
   -AggregatorOrSingleRackDefinitionRackSerialNumber <String>
   -AggregatorOrSingleRackDefinitionRackSkuId <String>
   -ClusterType <ClusterType>
   -ClusterVersion <String>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -Location <String>
   -NetworkFabricId <String>
   [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
   [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
   [-AggregatorOrSingleRackDefinitionRackLocation <String>]
   [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
   [-AnalyticsWorkspaceId <String>]
   [-ClusterLocation <String>]
   [-ClusterServicePrincipalApplicationId <String>]
   [-ClusterServicePrincipalId <String>]
   [-ClusterServicePrincipalPassword <SecureString>]
   [-ClusterServicePrincipalTenantId <String>]
   [-ComputeDeploymentThresholdGrouping <ValidationThresholdGrouping>]
   [-ComputeDeploymentThresholdType <ValidationThresholdType>]
   [-ComputeDeploymentThresholdValue <Int64>]
   [-ComputeRackDefinition <IRackDefinition[]>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

如果叢集存在，請建立新的叢集或更新叢集的屬性。

範例

範例 1：建立叢集

$storageapplianceconfigurationdata = @()
$baremetalmachineconfigurationdata = @()
$computerackdefinition = @(@{IRackDefinition = "The list of rack definitions for the compute racks in a multi-rackcluster, or an empty list in a single-rack cluster."})
$tagHash = @{
    tag = "tag"
}
$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudCluster -ResourceGroupName resourceGroup -Name clusterName -AggregatorOrSingleRackDefinitionNetworkRackId rackId -AggregatorOrSingleRackDefinitionRackSerialNumber sr1234 -AggregatorOrSingleRackDefinitionRackSkuId rackSku -ClusterType clustertype -ClusterVersion clusterversion -ExtendedLocationName CmExtendedLocation -ExtendedLocationType CustomLocation -Location location -NetworkFabricId networkFabricId -SubscriptionId subscriptionId -AggregatorOrSingleRackDefinitionAvailabilityZone avilabilityzone -AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration $baremetalmachineconfigurationdata -AggregatorOrSingleRackDefinitionRackLocation rackLocation -AggregatorOrSingleRackDefinitionStorageApplianceConfiguration $storageapplianceconfigurationdata -AnalyticsWorkspaceId anlyticsWorkSpaceId -ClusterServicePrincipalApplicationId clusterServicePrincipalAppId -ClusterServicePrincipalId ClusterServicePrincipalId -ClusterServicePrincipalPassword $securePassword -ClusterServicePrincipalTenantId tenantId -ComputeRackDefinition $computerackdefinition -Tag $tagHash

Location  Name             SystemDataCreatedAt   SystemDataCreatedBy       SystemDataCreatedByType  SystemDataLastModifiedAt SystemDataLastModifiedBy         SystemDataLastModifiedByType ResourceGroupName
--------  ---------        -------------------   -------------------       -----------------------  ------------------------ ------------------------         ---------------------------- -----------
eastus    clusterName      08/09/2023 18:33:54   user                    User                       08/09/2023 19:45:35      user                             User                         RGName

此命令會建立新的叢集。

參數

-AggregatorOrSingleRackDefinitionAvailabilityZone

建立時用於此機架的區域名稱。可用性區域用於工作負載放置。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

裸機計算機組態的未排序列表。若要建構，請參閱 AGGREGATORORSINGLERACKDEFINITIONBAREMETALMACHINECONFIGURATION 屬性和建立哈希表的 NOTES 一節。

類型:	IBareMetalMachineConfigurationData[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionNetworkRackId

符合此機架定義的網路機架資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionRackLocation

機架位置的自由格式描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionRackSerialNumber

網路雲端叢集中機架的唯一標識符。如有需要，可能會提供序號以外的替代唯一英數位元值。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionRackSkuId

要新增之機架的 SKU 資源識別碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

此機架的存放裝置設定資料清單。若要建構，請參閱 AGGREGATORORSINGLERACKDEFINITIONSTORAGEAPPLIANCECONFIGURATION 屬性和建立哈希表的 NOTES 一節。

類型:	IStorageApplianceConfigurationData[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AnalyticsWorkspaceId

將用於儲存相關記錄之Log Analytics工作區的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

以作業身分執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterLocation

客戶提供的位置資訊，以識別叢集所在的位置。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterServicePrincipalApplicationId

服務主體的應用程式識別碼，也稱為用戶端標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterServicePrincipalId

服務主體的主體標識碼，也稱為對象標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterServicePrincipalPassword

服務主體的密碼。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterServicePrincipalTenantId

建立服務主體之租使用者的租用戶標識符，也稱為目錄標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClusterType

叢集的機架組態類型。

類型:	ClusterType
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ClusterVersion

叢集目前的運行時間版本。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ComputeDeploymentThresholdGrouping

選取類型評估如何套用至叢集計算。

類型:	ValidationThresholdGrouping
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputeDeploymentThresholdType

選取應如何評估臨界值。

類型:	ValidationThresholdType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputeDeploymentThresholdValue

數值臨界值。

類型:	Int64
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputeRackDefinition

多機架叢集中電腦架的機架定義清單，或單一機架叢集中的空白清單。若要建構，請參閱 COMPUTERACKDEFINITION 屬性的 NOTES 區段並建立哈希表。

類型:	IRackDefinition[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

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

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

DefaultProfile 參數無法運作。如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:	PSObject
別名:	AzureRMContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationName

要在其中建立資源之擴充位置的資源標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ExtendedLocationType

擴充位置類型，例如 CustomLocation。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Location

資源所在的地理位置

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ManagedResourceGroupConfigurationLocation

受控資源群組的位置。如果未指定，則會選擇父資源的位置。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ManagedResourceGroupConfigurationName

受控資源群組的名稱。如果未指定，系統會自動產生唯一名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

叢集的名稱。

類型:	String
別名:	ClusterName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NetworkFabricId

與叢集相關聯的網路網狀架構資源標識符。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NoWait

以異步方式執行命令

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源群組的名稱。名稱不區分大小寫。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SubscriptionId

目標訂用帳戶的標識碼。此值必須是 UUID。

類型:	String
Position:	Named
預設值:	(Get-AzContext).Subscription.Id
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

資源標籤。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

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

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

ICluster

共用方式為