Update-AzNetworkCloudCluster

Module:

Az.NetworkCloud

Patch the properties of the provided cluster, or update the tags associated with the cluster. Properties and tag updates can be done independently.

Syntax

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>]

Description

Patch the properties of the provided cluster, or update the tags associated with the cluster. Properties and tag updates can be done independently.

Examples

Example 1: Update cluster

$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

Patch the properties of the provided cluster, or update the tags associated with the cluster. Properties and tag updates can be done independently.

Parameters

-AggregatorOrSingleRackDefinitionAvailabilityZone

The zone name used for this rack when created. Availability zones are used for workload placement.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

The unordered list of bare metal machine configuration. To construct, see NOTES section for AGGREGATORORSINGLERACKDEFINITIONBAREMETALMACHINECONFIGURATION properties and create a hash table.

Type:	IBareMetalMachineConfigurationData[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionNetworkRackId

The resource ID of the network rack that matches this rack definition.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionRackLocation

The free-form description of the rack's location.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionRackSerialNumber

The unique identifier for the rack within Network Cloud cluster. An alternate unique alphanumeric value other than a serial number may be provided if desired.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionRackSkuId

The resource ID of the sku for the rack being added.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

The list of storage appliance configuration data for this rack. To construct, see NOTES section for AGGREGATORORSINGLERACKDEFINITIONSTORAGEAPPLIANCECONFIGURATION properties and create a hash table.

Type:	IStorageApplianceConfigurationData[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Run the command as a job

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssociatedIdentityType

The type of managed identity that is being selected.

Type:	ManagedServiceIdentitySelectorType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssociatedIdentityUserAssignedIdentityResourceId

The user assigned managed identity resource ID to use. Mutually exclusive with a system assigned identity type.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterLocation

The customer-provided location information to identify where the cluster resides.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterServicePrincipalApplicationId

The application ID, also known as client ID, of the service principal.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterServicePrincipalId

The principal ID, also known as the object ID, of the service principal.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterServicePrincipalPassword

The password of the service principal.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterServicePrincipalTenantId

The tenant ID, also known as the directory ID, of the tenant in which the service principal is created.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandOutputSettingContainerUrl

The URL of the storage account container that is to be used by the specified identities.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeDeploymentThresholdGrouping

Selection of how the type evaluation is applied to the cluster calculation.

Type:	ValidationThresholdGrouping
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeDeploymentThresholdType

Selection of how the threshold should be evaluated.

Type:	ValidationThresholdType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeDeploymentThresholdValue

The numeric threshold value.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputeRackDefinition

The list of rack definitions for the compute racks in a multi-rackcluster, or an empty list in a single-rack cluster. To construct, see NOTES section for COMPUTERACKDEFINITION properties and create a hash table.

Type:	IRackDefinition[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

Type:	ManagedServiceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Type:	INetworkCloudIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

The name of the cluster.

Type:	String
Aliases:	ClusterName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Run the command asynchronously

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

The name of the resource group. The name is case insensitive.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RuntimeProtectionConfigurationEnforcementLevel

The mode of operation for runtime protection.

Type:	RuntimeProtectionEnforcementLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretArchiveKeyVaultId

The resource ID of the key vault to archive the secrets of the cluster.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretArchiveUseKeyVault

The indicator if the specified key vault should be used to archive the secrets of the cluster.

Type:	ClusterSecretArchiveEnabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

The ID of the target subscription. The value must be an UUID.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

The Azure resource tags that will replace the existing ones.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateStrategyMaxUnavailable

The maximum number of worker nodes that can be offline within the increment of update, e.g., rack-by-rack.Limited by the maximum number of machines in the increment. Defaults to the whole increment size.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateStrategyThresholdType

Selection of how the threshold should be evaluated.

Type:	ValidationThresholdType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateStrategyThresholdValue

The numeric threshold value.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateStrategyType

The mode of operation for runtime protection.

Type:	ClusterUpdateStrategyType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateStrategyWaitTimeMinute

The time to wait between the increments of update defined by the strategy.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

INetworkCloudIdentity

Outputs

ICluster