New-AzNetworkCloudCluster

Sintaxe

CreateExpanded (Default)

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

Description

Exemplos

Exemplo 1: Criar 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

Exemplo 2: Criar cluster com Identidade

$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

Parâmetros

-AggregatorOrSingleRackDefinitionAvailabilityZone

O nome da zona usado para este rack quando criado. As zonas de disponibilidade são usadas para o posicionamento da carga de trabalho.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

A lista não ordenada da configuração da máquina bare-metal.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionNetworkRackId

A ID do recurso do rack de rede que corresponde a essa definição de rack.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionRackLocation

A descrição de forma livre da localização do rack.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionRackSerialNumber

O identificador exclusivo do rack no cluster de Nuvem de Rede. Um valor alfanumérico exclusivo alternativo diferente de um número de série poderá ser fornecido, se desejado.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionRackSkuId

A ID do recurso do sku para o rack que está sendo adicionado.

Propriedades do parâmetro

Conjuntos de parâmetros

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

A lista de dados de configuração do dispositivo de armazenamento para este rack.

Propriedades do parâmetro

Conjuntos de parâmetros

-AnalyticOutputSettingAnalyticsWorkspaceId

A ID do recurso do workspace de análise que deve ser usado pela identidade especificada.

Propriedades do parâmetro

Conjuntos de parâmetros

-AnalyticsOutputSettingsAssociatedIdentityType

O tipo de identidade gerenciada que está sendo selecionado.

Propriedades do parâmetro

Conjuntos de parâmetros

-AnalyticsOutputSettingsAssociatedIdentityUserAssignedIdentityResourceId

A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusiva com relação a um tipo de identidade atribuída pelo sistema.

Propriedades do parâmetro

Conjuntos de parâmetros

-AnalyticsWorkspaceId

Campo preterido. A ID do recurso do workspace do Log Analytics que será usado para armazenar logs relevantes.

Propriedades do parâmetro

Conjuntos de parâmetros

-AsJob

Executar o comando como um trabalho

Propriedades do parâmetro

Conjuntos de parâmetros

-AssociatedIdentityType

O tipo de identidade associada para CommandOutputSettings.

Propriedades do parâmetro

Conjuntos de parâmetros

-AssociatedIdentityUserAssignedIdentityResourceId

A ID do recurso da identidade atribuída pelo usuário para CommandOutputSettings.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterLocation

As informações de localização fornecidas pelo cliente para identificar onde o cluster reside.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterServicePrincipalApplicationId

A ID do aplicativo, também conhecida como ID do cliente, da entidade de serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterServicePrincipalId

A ID da entidade de segurança, também conhecida como ID do objeto, da entidade de serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterServicePrincipalPassword

A senha da entidade de serviço.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterServicePrincipalTenantId

A ID do locatário, também conhecida como ID do diretório, do locatário no qual a entidade de serviço é criada.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterType

O tipo de configuração de rack para o cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-ClusterVersion

A versão atual do runtime do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-CommandOutputSettingContainerUrl

A URL do contêiner da conta de armazenamento que deve ser usada pelas identidades especificadas.

Propriedades do parâmetro

Conjuntos de parâmetros

-ComputeDeploymentThresholdGrouping

Seleção de como a avaliação de tipo é aplicada ao cálculo do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-ComputeDeploymentThresholdType

Seleção de como o limite deve ser avaliado.

Propriedades do parâmetro

Conjuntos de parâmetros

-ComputeDeploymentThresholdValue

O valor do limite numérico.

Propriedades do parâmetro

Conjuntos de parâmetros

-ComputeRackDefinition

A lista de definições de rack para os racks de computação em um cluster de vários racks ou uma lista vazia em um cluster de rack único.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableSystemAssignedIdentity

Determina se uma identidade atribuída pelo sistema deve ser habilitada para o recurso.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtendedLocationName

A ID do recurso do local estendido no qual o recurso será criado.

Propriedades do parâmetro

Conjuntos de parâmetros

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

Propriedades do parâmetro

Conjuntos de parâmetros

-IfMatch

A ETag da transformação. Omita esse valor para sempre substituir o recurso atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.

Propriedades do parâmetro

Conjuntos de parâmetros

-IfNoneMatch

Defina como '*' para permitir que um novo conjunto de registros seja criado, mas para impedir a atualização de um recurso existente. Outros valores resultarão em erro do servidor, pois não têm suporte.

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Propriedades do parâmetro

Conjuntos de parâmetros

-Location

A localização geográfica onde o recurso reside

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedResourceGroupConfigurationLocation

O local do grupo de recursos gerenciados. Se não for especificado, o local do recurso pai será escolhido.

Propriedades do parâmetro

Conjuntos de parâmetros

-ManagedResourceGroupConfigurationName

O nome do grupo de recursos gerenciado. Se não for especificado, o nome exclusivo será gerado automaticamente.

Propriedades do parâmetro

Conjuntos de parâmetros

-Name

O nome do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-NetworkFabricId

A ID do recurso do Network Fabric associado ao cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-NoWait

Execute o comando de forma assíncrona

Propriedades do parâmetro

Conjuntos de parâmetros

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades do parâmetro

Conjuntos de parâmetros

-RuntimeProtectionConfigurationEnforcementLevel

O modo de operação para proteção de runtime.

Propriedades do parâmetro

Conjuntos de parâmetros

-SecretArchiveKeyVaultId

A ID do recurso do cofre de chaves para arquivar os segredos do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-SecretArchiveSettingsAssociatedIdentityType

O tipo de identidade gerenciada que está sendo selecionado.

Propriedades do parâmetro

Conjuntos de parâmetros

-SecretArchiveSettingsAssociatedIdentityUserAssignedIdentityResourceId

A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusiva com relação a um tipo de identidade atribuída pelo sistema.

Propriedades do parâmetro

Conjuntos de parâmetros

-SecretArchiveSettingVaultUri

O URI do cofre de chaves usado como o arquivo secreto.

Propriedades do parâmetro

Conjuntos de parâmetros

-SecretArchiveUseKeyVault

O indicador se o cofre de chaves especificado deve ser usado para arquivar os segredos do cluster.

Propriedades do parâmetro

Conjuntos de parâmetros

-SubscriptionId

A ID da assinatura de destino. O valor deve ser uma UUID.

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Tags de recursos.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpdateStrategyMaxUnavailable

O número máximo de nós de trabalho que podem estar offline dentro do incremento da atualização, por exemplo, rack por rack. Limitado pelo número máximo de computadores no incremento. O padrão é todo o tamanho de incremento.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpdateStrategyThresholdType

Seleção de como o limite deve ser avaliado.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpdateStrategyThresholdValue

O valor do limite numérico.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpdateStrategyType

O modo de operação para proteção de runtime.

Propriedades do parâmetro

Conjuntos de parâmetros

-UpdateStrategyWaitTimeMinute

O tempo de espera entre os incrementos de atualização definidos pela estratégia.

Propriedades do parâmetro

Conjuntos de parâmetros

-UserAssignedIdentity

A matriz de identidades atribuídas pelo usuário associadas ao recurso. Os elementos na matriz serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.'

Propriedades do parâmetro

Conjuntos de parâmetros

-VulnerabilityScanningSettingContainerScan

A seleção de modo para verificação de vulnerabilidade de contêiner.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Saídas

ICluster