Compartilhar via

New-AzNetworkCloudCluster

  • Referência
Módulo:
Az.NetworkCloud

Crie um novo cluster ou atualize as propriedades do cluster se ele existir.

Sintaxe

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

Description

Crie um novo cluster ou atualize as propriedades do cluster se ele existir.

Exemplos

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

Esse comando cria um novo cluster.

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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

A lista não ordenada da configuração da máquina bare-metal. Para construir, consulte a seção NOTES para propriedades AGGREGATORORSINGLERACKDEFINITIONBAREMETALMACHINECONFIGURATION e crie uma tabela de hash.

Tipo:IBareMetalMachineConfigurationData[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AggregatorOrSingleRackDefinitionNetworkRackId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AggregatorOrSingleRackDefinitionRackLocation

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AggregatorOrSingleRackDefinitionRackSkuId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

A lista de dados de configuração do dispositivo de armazenamento para este rack. Para construir, consulte a seção NOTES para propriedades AGGREGATORORSINGLERACKDEFINITIONSTORAGEAPPLIANCECONFIGURATION e crie uma tabela de hash.

Tipo:IStorageApplianceConfigurationData[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AnalyticsWorkspaceId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AssociatedIdentityType

O tipo de identidade gerenciada que está sendo selecionado.

Tipo:ManagedServiceIdentitySelectorType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AssociatedIdentityUserAssignedIdentityResourceId

A ID do recurso de identidade gerenciada atribuída pelo usuário a ser usada. Mutuamente exclusivo com um tipo de identidade atribuído pelo sistema.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterLocation

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterServicePrincipalApplicationId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterServicePrincipalId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterServicePrincipalPassword

A senha da entidade de serviço.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterType

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

Tipo:ClusterType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClusterVersion

A versão atual do runtime do cluster.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CommandOutputSettingContainerUrl

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeDeploymentThresholdGrouping

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

Tipo:ValidationThresholdGrouping
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeDeploymentThresholdType

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

Tipo:ValidationThresholdType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeDeploymentThresholdValue

O valor do limite numérico.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeRackDefinition

A lista de definições de rack para os racks de computação em um cluster multi-rack ou uma lista vazia em um cluster de rack único. Para construir, consulte a seção NOTES para propriedades COMPUTERACKDEFINITION e crie uma tabela de hash.

Tipo:IRackDefinition[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtendedLocationName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

Tipo:ManagedServiceIdentityType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityUserAssignedIdentity

O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedResourceGroupConfigurationLocation

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedResourceGroupConfigurationName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome do cluster.

Tipo:String
Aliases:ClusterName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkFabricId

A ID do recurso do Network Fabric associado ao cluster.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Executar o comando de forma assíncrona

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RuntimeProtectionConfigurationEnforcementLevel

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

Tipo:RuntimeProtectionEnforcementLevel
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecretArchiveKeyVaultId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecretArchiveUseKeyVault

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

Tipo:ClusterSecretArchiveEnabled
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

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

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

Marcas de recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateStrategyThresholdType

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

Tipo:ValidationThresholdType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateStrategyThresholdValue

O valor do limite numérico.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateStrategyType

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

Tipo:ClusterUpdateStrategyType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateStrategyWaitTimeMinute

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

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas