通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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>]
   [-AssociatedIdentityType <ManagedServiceIdentitySelectorType>]
   [-AssociatedIdentityUserAssignedIdentityResourceId <String>]
   [-ClusterLocation <String>]
   [-ClusterServicePrincipalApplicationId <String>]
   [-ClusterServicePrincipalId <String>]
   [-ClusterServicePrincipalPassword <SecureString>]
   [-ClusterServicePrincipalTenantId <String>]
   [-CommandOutputSettingContainerUrl <String>]
   [-ComputeDeploymentThresholdGrouping <ValidationThresholdGrouping>]
   [-ComputeDeploymentThresholdType <ValidationThresholdType>]
   [-ComputeDeploymentThresholdValue <Int64>]
   [-ComputeRackDefinition <IRackDefinition[]>]
   [-IdentityType <ManagedServiceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-ManagedResourceGroupConfigurationLocation <String>]
   [-ManagedResourceGroupConfigurationName <String>]
   [-RuntimeProtectionConfigurationEnforcementLevel <RuntimeProtectionEnforcementLevel>]
   [-SecretArchiveKeyVaultId <String>]
   [-SecretArchiveUseKeyVault <ClusterSecretArchiveEnabled>]
   [-Tag <Hashtable>]
   [-UpdateStrategyMaxUnavailable <Int64>]
   [-UpdateStrategyThresholdType <ValidationThresholdType>]
   [-UpdateStrategyThresholdValue <Int64>]
   [-UpdateStrategyType <ClusterUpdateStrategyType>]
   [-UpdateStrategyWaitTimeMinute <Int64>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新群集或更新群集的属性（如果存在）。

示例

示例 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

与此机架定义匹配的网络机架的资源 ID。

类型: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 的资源 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

此机架的存储设备配置数据列表。 若要构造，请参阅 AGGREGATORORSINGLERACKDEFINITIONSTORAGEAPPLIANCECONFIGURATION 属性的 NOTES 部分并创建哈希表。

类型:IStorageApplianceConfigurationData[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AnalyticsWorkspaceId

将用于存储相关日志的 Log Analytics 工作区的资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AssociatedIdentityType

正在选择的托管标识的类型。

类型:ManagedServiceIdentitySelectorType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AssociatedIdentityUserAssignedIdentityResourceId

用户分配的托管标识资源 ID 要使用的 ID。 与系统分配的标识类型互斥。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterLocation

客户提供的位置信息，用于标识群集所在的位置。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterServicePrincipalApplicationId

服务主体的应用程序 ID（也称为客户端 ID）。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterServicePrincipalId

服务主体的主体 ID（也称为对象 ID）。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterServicePrincipalPassword

服务主体的密码。

类型:SecureString
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterServicePrincipalTenantId

在其中创建服务主体的租户的租户 ID（也称为目录 ID）。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterType

群集的机架配置类型。

类型:ClusterType
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ClusterVersion

群集的当前运行时版本。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-CommandOutputSettingContainerUrl

要由指定标识使用的存储帐户容器的 URL。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入: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

要在其中创建资源的扩展位置的资源 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ExtendedLocationType

扩展的位置类型，例如 CustomLocation。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-IdentityType

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

类型:ManagedServiceIdentityType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IdentityUserAssignedIdentity

与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象（{}）。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入: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

与群集关联的 Network Fabric 的资源 ID。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RuntimeProtectionConfigurationEnforcementLevel

运行时保护的操作模式。

类型:RuntimeProtectionEnforcementLevel
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SecretArchiveKeyVaultId

用于存档群集机密的密钥保管库的资源 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SecretArchiveUseKeyVault

如果应使用指定的密钥保管库来存档群集的机密，则指示符。

类型:ClusterSecretArchiveEnabled
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubscriptionId

目标订阅的 ID。 该值必须是 UUID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记。

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateStrategyMaxUnavailable

可在更新增量内脱机的辅助角色节点的最大数目，例如逐机架。按增量限制的最大计算机数。 默认为整个增量大小。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateStrategyThresholdType

选择应如何评估阈值。

类型:ValidationThresholdType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateStrategyThresholdValue

数值阈值。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateStrategyType

运行时保护的操作模式。

类型:ClusterUpdateStrategyType
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UpdateStrategyWaitTimeMinute

策略定义的更新增量之间的等待时间。

类型:Int64
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输出

ICluster