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

Update-AzNetworkCloudCluster

参考

模块:: Az.NetworkCloud

修补提供的群集的属性，或更新与群集关联的标记。属性和标记更新可以独立完成。

语法

Update-AzNetworkCloudCluster
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
      [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
      [-AggregatorOrSingleRackDefinitionNetworkRackId <String>]
      [-AggregatorOrSingleRackDefinitionRackLocation <String>]
      [-AggregatorOrSingleRackDefinitionRackSerialNumber <String>]
      [-AggregatorOrSingleRackDefinitionRackSkuId <String>]
      [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
      [-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>]
      [-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>]

Update-AzNetworkCloudCluster
      -InputObject <INetworkCloudIdentity>
      [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
      [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
      [-AggregatorOrSingleRackDefinitionNetworkRackId <String>]
      [-AggregatorOrSingleRackDefinitionRackLocation <String>]
      [-AggregatorOrSingleRackDefinitionRackSerialNumber <String>]
      [-AggregatorOrSingleRackDefinitionRackSkuId <String>]
      [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
      [-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>]
      [-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"
    tagUpdate = "tagUpdate"
}
$securePassword = ConvertTo-SecureString "password" -asplaintext -force

Update-AzNetworkCloudCluster -ResourceGroupName resourceGroup -Name clusterName -SubscriptionId subscriptionId -AggregatorOrSingleRackDefinitionNetworkRackId rackId -AggregatorOrSingleRackDefinitionRackSerialNumber sr1234 -AggregatorOrSingleRackDefinitionRackSkuId rackSku -AggregatorOrSingleRackDefinitionAvailabilityZone availabilityzone -AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration $baremetalmachineconfigurationdata -AggregatorOrSingleRackDefinitionRackLocation rackLocation -AggregatorOrSingleRackDefinitionStorageApplianceConfiguration $storageapplianceconfigurationdata -ClusterServicePrincipalApplicationId clusterServicePrincipalAppId -ClusterServicePrincipalId ClusterServicePrincipalId -ClusterServicePrincipalPassword $securePassword -ClusterServicePrincipalTenantId tenantId -ComputeRackDefinition $computerackdefinition -Tag $tagHash

Location Name             SystemDataCreatedAt SystemDataCreatedBy       SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGro
                                                                                                                                                                                           upName
-------- ----             ------------------- -------------------       ----------------------- ------------------------ ------------------------             ---------------------------- -----------
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
必需:	False
接受管道输入:	False
接受通配符:	False

-AggregatorOrSingleRackDefinitionRackLocation

机架位置的自由形式说明。

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

-AggregatorOrSingleRackDefinitionRackSerialNumber

网络云群集中机架的唯一标识符。如果需要，可以提供除序列号以外的备用唯一字母数字值。

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

-AggregatorOrSingleRackDefinitionRackSkuId

要添加机架的 SKU 的资源 ID。

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

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

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

类型:	IStorageApplianceConfigurationData[]
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

-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

-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

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

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

-Name

群集的名称。

类型:	String
别名:	ClusterName
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

将替换现有标记的 Azure 资源标记。

类型:	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 运行时会发生什么情况。 cmdlet 未运行。

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

输入

INetworkCloudIdentity

输出

ICluster

通过

Update-AzNetworkCloudCluster

语法

说明

示例

示例 1：更新群集

参数

-AggregatorOrSingleRackDefinitionAvailabilityZone

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

-AggregatorOrSingleRackDefinitionNetworkRackId

-AggregatorOrSingleRackDefinitionRackLocation

-AggregatorOrSingleRackDefinitionRackSerialNumber

-AggregatorOrSingleRackDefinitionRackSkuId

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

-AsJob

-AssociatedIdentityType

-AssociatedIdentityUserAssignedIdentityResourceId

-ClusterLocation

-ClusterServicePrincipalApplicationId

-ClusterServicePrincipalId

-ClusterServicePrincipalPassword

-ClusterServicePrincipalTenantId

-CommandOutputSettingContainerUrl

-ComputeDeploymentThresholdGrouping

-ComputeDeploymentThresholdType

-ComputeDeploymentThresholdValue

-ComputeRackDefinition

-Confirm

-DefaultProfile

-IdentityType

-IdentityUserAssignedIdentity

-InputObject

-Name

-NoWait

-ResourceGroupName

-RuntimeProtectionConfigurationEnforcementLevel

-SecretArchiveKeyVaultId

-SecretArchiveUseKeyVault

-SubscriptionId

-Tag

-UpdateStrategyMaxUnavailable

-UpdateStrategyThresholdType

-UpdateStrategyThresholdValue

-UpdateStrategyType

-UpdateStrategyWaitTimeMinute

-WhatIf

输入

输出

其他资源