New-AzNetworkCloudCluster

Sintassi

CreateExpanded (Impostazione predefinita)

New-AzNetworkCloudCluster
    -Name <String>
    -ResourceGroupName <String>
    -AggregatorOrSingleRackDefinitionNetworkRackId <String>
    -AggregatorOrSingleRackDefinitionRackSerialNumber <String>
    -AggregatorOrSingleRackDefinitionRackSkuId <String>
    -ClusterType <String>
    -ClusterVersion <String>
    -ExtendedLocationName <String>
    -ExtendedLocationType <String>
    -Location <String>
    -NetworkFabricId <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
    [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
    [-AggregatorOrSingleRackDefinitionRackLocation <String>]
    [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
    [-AnalyticOutputSettingAnalyticsWorkspaceId <String>]
    [-AnalyticsOutputSettingsAssociatedIdentityType <String>]
    [-AnalyticsOutputSettingsAssociatedIdentityUserAssignedIdentityResourceId <String>]
    [-AnalyticsWorkspaceId <String>]
    [-AssociatedIdentityType <String>]
    [-AssociatedIdentityUserAssignedIdentityResourceId <String>]
    [-ClusterLocation <String>]
    [-ClusterServicePrincipalApplicationId <String>]
    [-ClusterServicePrincipalId <String>]
    [-ClusterServicePrincipalPassword <SecureString>]
    [-ClusterServicePrincipalTenantId <String>]
    [-CommandOutputSettingContainerUrl <String>]
    [-CommandOutputSettingOverride <ICommandOutputOverride[]>]
    [-ComputeDeploymentThresholdGrouping <String>]
    [-ComputeDeploymentThresholdType <String>]
    [-ComputeDeploymentThresholdValue <Int64>]
    [-ComputeRackDefinition <IRackDefinition[]>]
    [-EnableSystemAssignedIdentity]
    [-ManagedResourceGroupConfigurationLocation <String>]
    [-ManagedResourceGroupConfigurationName <String>]
    [-RuntimeProtectionConfigurationEnforcementLevel <String>]
    [-SecretArchiveKeyVaultId <String>]
    [-SecretArchiveSettingVaultUri <String>]
    [-SecretArchiveSettingsAssociatedIdentityType <String>]
    [-SecretArchiveSettingsAssociatedIdentityUserAssignedIdentityResourceId <String>]
    [-SecretArchiveUseKeyVault <String>]
    [-Tag <Hashtable>]
    [-UpdateStrategyMaxUnavailable <Int64>]
    [-UpdateStrategyThresholdType <String>]
    [-UpdateStrategyThresholdValue <Int64>]
    [-UpdateStrategyType <String>]
    [-UpdateStrategyWaitTimeMinute <Int64>]
    [-UserAssignedIdentity <String[]>]
    [-VulnerabilityScanningSettingContainerScan <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzNetworkCloudCluster
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Esempio

Esempio 1: Creare un cluster

$storageapplianceconfigurationdata = @()
$baremetalmachineconfigurationdata = @()
$computerackdefinition = @(@{IRackDefinition = "The list of rack definitions for the compute racks in a multi-rack cluster, 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 availabilityzone -AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration $baremetalmachineconfigurationdata -AggregatorOrSingleRackDefinitionRackLocation rackLocation -AggregatorOrSingleRackDefinitionStorageApplianceConfiguration $storageapplianceconfigurationdata -AnalyticsWorkspaceId analyticsWorkSpaceId -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

Esempio 2: Creare un cluster con Identità

$storageapplianceconfigurationdata = @()
$baremetalmachineconfigurationdata = @()
$computerackdefinition = @(@{IRackDefinition = "The list of rack definitions for the compute racks in a multi-rack cluster, or an empty list in a single-rack cluster."})
$tagHash = @{
    tag = "tag"
}
$securePassword = ConvertTo-SecureString "password" -asplaintext -force
$userAssignedIdentityResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myManagedIdentity"


New-AzNetworkCloudCluster -ResourceGroupName resourceGroup -Name clusterName -AggregatorOrSingleRackDefinitionNetworkRackId rackId -AggregatorOrSingleRackDefinitionRackSerialNumber sr1234 -AggregatorOrSingleRackDefinitionRackSkuId rackSku -ClusterType clustertype -UserAssignedIdentity $userAssignedIdentityResourceId -ClusterVersion clusterversion -ExtendedLocationName CmExtendedLocation -ExtendedLocationType CustomLocation -Location location -NetworkFabricId networkFabricId -SubscriptionId subscriptionId -AggregatorOrSingleRackDefinitionAvailabilityZone availabilityZone -AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration $baremetalmachineconfigurationdata -AggregatorOrSingleRackDefinitionRackLocation rackLocation -AggregatorOrSingleRackDefinitionStorageApplianceConfiguration $storageapplianceconfigurationdata -AnalyticOutputSettingAnalyticsWorkspaceId analyticsWorkspaceId -AnalyticsOutputSettingsAssociatedIdentityType identityType -AnalyticsOutputSettingsAssociatedIdentityUserAssignedIdentityResourceId userAssignedIdentityResourceId -AnalyticsWorkspaceId analyticsWorkspaceId -CommandOutputSettingContainerUrl containerUrl -AssociatedIdentityType commandOutputSettingsIdentityType -AssociatedIdentityUserAssignedIdentityResourceId commandOutputSettingsUserAssignedIdentityResourceId -ClusterServicePrincipalApplicationId clusterServicePrincipalAppId -ClusterServicePrincipalId ClusterServicePrincipalId -ClusterServicePrincipalPassword $securePassword -ClusterServicePrincipalTenantId tenantId -ComputeRackDefinition $computerackdefinition -SecretArchiveKeyVaultId keyVaultId -SecretArchiveSettingVaultUri keyVaultUri -SecretArchiveSettingsAssociatedIdentityType identityType -SecretArchiveSettingsAssociatedIdentityUserAssignedIdentityResourceId userAssignedIdentityResourceId -SecretArchiveUseKeyVault useKeyVault -UpdateStrategyThresholdType updateStrategyThresholdType -UpdateStrategyThresholdValue updateStrategyThresholdValue -UpdateStrategyType updateStrategyType -UpdateStrategyWaitTimeMinute updateStrategyWaitTimeMinutes -VulnerabilityScanningSettingContainerScan vulnerabilityScanningSettingContainerScan -ComputeDeploymentThresholdGrouping computeDeploymentThresholdGrouping -ComputeDeploymentThresholdType computeDeploymentThresholdType -ComputeDeploymentThresholdValue computeDeploymentThresholdValue -Tag $tagHash

Location  Name             SystemDataCreatedAt   SystemDataCreatedBy       SystemDataCreatedByType  SystemDataLastModifiedAt SystemDataLastModifiedBy         SystemDataLastModifiedByType ResourceGroupName
--------  ---------        -------------------   -------------------       -----------------------  ------------------------ ------------------------         ---------------------------- -----------
uksouth    clusterName      04/10/2025 18:14:18   user                    User                       04/10/2025 18:16:10      user                             User                         RGName

Parametri

-AggregatorOrSingleRackDefinitionAvailabilityZone

Nome della zona usato per questo rack al momento della creazione. Le zone di disponibilità vengono usate per il posizionamento del carico di lavoro.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

Elenco non ordinato della configurazione della macchina bare metal.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionNetworkRackId

ID risorsa del rack di rete che corrisponde a questa definizione del rack.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionRackLocation

Descrizione in formato libero della posizione del rack.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionRackSerialNumber

Identificatore univoco per il rack all'interno del cluster cloud di rete. È possibile specificare un valore alfanumerico univoco alternativo diverso da un numero di serie, se necessario.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionRackSkuId

ID risorsa dello SKU per il rack da aggiungere.

Proprietà dei parametri

Set di parametri

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

Elenco dei dati di configurazione dell'appliance di archiviazione per questo rack.

Proprietà dei parametri

Set di parametri

-AnalyticOutputSettingAnalyticsWorkspaceId

ID risorsa dell'area di lavoro di analisi che deve essere usata dall'identità specificata.

Proprietà dei parametri

Set di parametri

-AnalyticsOutputSettingsAssociatedIdentityType

Tipo di identità gestita selezionata.

Proprietà dei parametri

Set di parametri

-AnalyticsOutputSettingsAssociatedIdentityUserAssignedIdentityResourceId

ID risorsa identità gestita assegnata dall'utente da usare. Mutuamente esclusivo con un tipo di identità assegnata dal sistema.

Proprietà dei parametri

Set di parametri

-AnalyticsWorkspaceId

Campo Deprecato. ID risorsa dell'area di lavoro Log Analytics che verrà usata per archiviare i log pertinenti.

Proprietà dei parametri

Set di parametri

-AsJob

Eseguire il comando come processo

Proprietà dei parametri

Set di parametri

-AssociatedIdentityType

Tipo di identità associata per CommandOutputSettings.

Proprietà dei parametri

Set di parametri

-AssociatedIdentityUserAssignedIdentityResourceId

ID risorsa dell'identità assegnata dall'utente per CommandOutputSettings.

Proprietà dei parametri

Set di parametri

-ClusterLocation

Informazioni sulla posizione fornite dal cliente per identificare dove risiede il cluster.

Proprietà dei parametri

Set di parametri

-ClusterServicePrincipalApplicationId

ID applicazione, noto anche come ID client, dell'entità servizio.

Proprietà dei parametri

Set di parametri

-ClusterServicePrincipalId

ID entità, noto anche come ID oggetto, dell'entità servizio.

Proprietà dei parametri

Set di parametri

-ClusterServicePrincipalPassword

Password dell'entità servizio.

Proprietà dei parametri

Set di parametri

-ClusterServicePrincipalTenantId

ID tenant, noto anche come ID directory, del tenant in cui viene creata l'entità servizio.

Proprietà dei parametri

Set di parametri

-ClusterType

Tipo di configurazione del rack per il cluster.

Proprietà dei parametri

Set di parametri

-ClusterVersion

Versione di runtime corrente del cluster.

Proprietà dei parametri

Set di parametri

-CommandOutputSettingContainerUrl

URL del contenitore dell'account di archiviazione che deve essere usato dalle identità specificate.

Proprietà dei parametri

Set di parametri

-CommandOutputSettingOverride

Elenco di sostituzioni facoltative che consentono l'associazione di contenitori di archiviazione e identità a tipi specifici di output del comando. Se non viene eseguito l'override di un tipo, verranno utilizzati l'identità predefinita e il contenitore di archiviazione.

Proprietà dei parametri

Set di parametri

-ComputeDeploymentThresholdGrouping

Selezione della modalità di applicazione della valutazione del tipo al calcolo del cluster.

Proprietà dei parametri

Set di parametri

-ComputeDeploymentThresholdType

Selezione della modalità di valutazione della soglia.

Proprietà dei parametri

Set di parametri

-ComputeDeploymentThresholdValue

Valore soglia numerico.

Proprietà dei parametri

Set di parametri

-ComputeRackDefinition

Elenco di definizioni di rack per i rack di calcolo in un cluster multi-rack o un elenco vuoto in un cluster a rack singolo.

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Proprietà dei parametri

Set di parametri

-EnableSystemAssignedIdentity

Determina se abilitare un'identità assegnata dal sistema per la risorsa.

Proprietà dei parametri

Set di parametri

-ExtendedLocationName

ID risorsa del percorso esteso in cui verrà creata la risorsa.

Proprietà dei parametri

Set di parametri

-ExtendedLocationType

Tipo di posizione estesa, ad esempio CustomLocation.

Proprietà dei parametri

Set di parametri

-IfMatch

ETag della trasformazione. Omettere questo valore per sovrascrivere sempre la risorsa corrente. Specificare l'ultimo valore ETag visualizzato per impedire la sovrascrittura accidentale delle modifiche simultanee.

Proprietà dei parametri

Set di parametri

-IfNoneMatch

Impostare su '*' per consentire la creazione di un nuovo set di record, ma per impedire l'aggiornamento di una risorsa esistente. Gli altri valori genereranno errori dal server perché non sono supportati.

Proprietà dei parametri

Set di parametri

-JsonFilePath

Percorso del file JSON fornito all'operazione di creazione

Proprietà dei parametri

Set di parametri

-JsonString

Stringa JSON fornita all'operazione di creazione

Proprietà dei parametri

Set di parametri

-Location

Posizione geografica in cui risiede la risorsa

Proprietà dei parametri

Set di parametri

-ManagedResourceGroupConfigurationLocation

Posizione del gruppo di risorse gestite. Se non specificato, viene scelta la posizione della risorsa padre.

Proprietà dei parametri

Set di parametri

-ManagedResourceGroupConfigurationName

Nome del gruppo di risorse gestite. Se non specificato, il nome univoco viene generato automaticamente.

Proprietà dei parametri

Set di parametri

-Name

Nome del cluster.

Proprietà dei parametri

Set di parametri

-NetworkFabricId

ID risorsa dell'infrastruttura di rete associata al cluster.

Proprietà dei parametri

Set di parametri

-NoWait

Eseguire il comando in modo asincrono

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

Proprietà dei parametri

Set di parametri

-RuntimeProtectionConfigurationEnforcementLevel

Modalità di funzionamento per la protezione del runtime.

Proprietà dei parametri

Set di parametri

-SecretArchiveKeyVaultId

ID risorsa dell'insieme di credenziali delle chiavi per archiviare i segreti del cluster.

Proprietà dei parametri

Set di parametri

-SecretArchiveSettingsAssociatedIdentityType

Tipo di identità gestita selezionata.

Proprietà dei parametri

Set di parametri

-SecretArchiveSettingsAssociatedIdentityUserAssignedIdentityResourceId

ID risorsa identità gestita assegnata dall'utente da usare. Mutuamente esclusivo con un tipo di identità assegnata dal sistema.

Proprietà dei parametri

Set di parametri

-SecretArchiveSettingVaultUri

URI per l'insieme di credenziali delle chiavi usato come archivio segreto.

Proprietà dei parametri

Set di parametri

-SecretArchiveUseKeyVault

Indicatore se l'insieme di credenziali delle chiavi specificato deve essere usato per archiviare i segreti del cluster.

Proprietà dei parametri

Set di parametri

-SubscriptionId

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

Proprietà dei parametri

Set di parametri

-Tag

Tag delle risorse.

Proprietà dei parametri

Set di parametri

-UpdateStrategyMaxUnavailable

Numero massimo di nodi di lavoro che possono essere offline all'interno dell'incremento dell'aggiornamento, ad esempio rack per rack. Limitato dal numero massimo di computer nell'incremento. L'impostazione predefinita è l'intera dimensione dell'incremento.

Proprietà dei parametri

Set di parametri

-UpdateStrategyThresholdType

Selezione della modalità di valutazione della soglia.

Proprietà dei parametri

Set di parametri

-UpdateStrategyThresholdValue

Valore soglia numerico.

Proprietà dei parametri

Set di parametri

-UpdateStrategyType

Modalità di funzionamento per la protezione del runtime.

Proprietà dei parametri

Set di parametri

-UpdateStrategyWaitTimeMinute

Tempo di attesa tra gli incrementi di aggiornamento definiti dalla strategia.

Proprietà dei parametri

Set di parametri

-UserAssignedIdentity

Matrice di identità assegnate dall'utente associate alla risorsa. Gli elementi nella matrice saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'

Proprietà dei parametri

Set di parametri

-VulnerabilityScanningSettingContainerScan

Selezione della modalità per l'analisi delle vulnerabilità dei contenitori.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

CommonParameters

Output

ICluster