Partager via


Update-AzKustoCluster

Mettez à jour un cluster Kusto.

Syntaxe

Update-AzKustoCluster
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-IfMatch <String>]
      [-AcceptedAudience <IAcceptedAudiences[]>]
      [-AllowedFqdnList <String[]>]
      [-AllowedIPRangeList <String[]>]
      [-CalloutPolicy <ICalloutPolicy[]>]
      [-EnableAutoStop]
      [-EnableDiskEncryption]
      [-EnableDoubleEncryption]
      [-EnablePurge]
      [-EnableStreamingIngest]
      [-EngineType <EngineType>]
      [-IdentityType <IdentityType>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-KeyVaultPropertyKeyName <String>]
      [-KeyVaultPropertyKeyVaultUri <String>]
      [-KeyVaultPropertyKeyVersion <String>]
      [-KeyVaultPropertyUserIdentity <String>]
      [-LanguageExtensionValue <ILanguageExtension[]>]
      [-Location <String>]
      [-OptimizedAutoscaleIsEnabled]
      [-OptimizedAutoscaleMaximum <Int32>]
      [-OptimizedAutoscaleMinimum <Int32>]
      [-OptimizedAutoscaleVersion <Int32>]
      [-PublicIPType <PublicIPType>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-RestrictOutboundNetworkAccess <ClusterNetworkAccessFlag>]
      [-SkuCapacity <Int32>]
      [-SkuName <AzureSkuName>]
      [-SkuTier <AzureSkuTier>]
      [-Tag <Hashtable>]
      [-TrustedExternalTenant <ITrustedExternalTenant[]>]
      [-VirtualClusterGraduationProperty <String>]
      [-VirtualNetworkConfigurationDataManagementPublicIPId <String>]
      [-VirtualNetworkConfigurationEnginePublicIPId <String>]
      [-VirtualNetworkConfigurationState <VnetState>]
      [-VirtualNetworkConfigurationSubnetId <String>]
      [-Zone <String[]>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzKustoCluster
      -InputObject <IKustoIdentity>
      [-IfMatch <String>]
      [-AcceptedAudience <IAcceptedAudiences[]>]
      [-AllowedFqdnList <String[]>]
      [-AllowedIPRangeList <String[]>]
      [-CalloutPolicy <ICalloutPolicy[]>]
      [-EnableAutoStop]
      [-EnableDiskEncryption]
      [-EnableDoubleEncryption]
      [-EnablePurge]
      [-EnableStreamingIngest]
      [-EngineType <EngineType>]
      [-IdentityType <IdentityType>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-KeyVaultPropertyKeyName <String>]
      [-KeyVaultPropertyKeyVaultUri <String>]
      [-KeyVaultPropertyKeyVersion <String>]
      [-KeyVaultPropertyUserIdentity <String>]
      [-LanguageExtensionValue <ILanguageExtension[]>]
      [-Location <String>]
      [-OptimizedAutoscaleIsEnabled]
      [-OptimizedAutoscaleMaximum <Int32>]
      [-OptimizedAutoscaleMinimum <Int32>]
      [-OptimizedAutoscaleVersion <Int32>]
      [-PublicIPType <PublicIPType>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-RestrictOutboundNetworkAccess <ClusterNetworkAccessFlag>]
      [-SkuCapacity <Int32>]
      [-SkuName <AzureSkuName>]
      [-SkuTier <AzureSkuTier>]
      [-Tag <Hashtable>]
      [-TrustedExternalTenant <ITrustedExternalTenant[]>]
      [-VirtualClusterGraduationProperty <String>]
      [-VirtualNetworkConfigurationDataManagementPublicIPId <String>]
      [-VirtualNetworkConfigurationEnginePublicIPId <String>]
      [-VirtualNetworkConfigurationState <VnetState>]
      [-VirtualNetworkConfigurationSubnetId <String>]
      [-Zone <String[]>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Mettez à jour un cluster Kusto.

Exemples

Exemple 1 : Mettre à jour un cluster existant par nom

Update-AzKustoCluster -ResourceGroupName testrg -Name testnewkustocluster -SkuName Standard_D12_v2 -SkuTier Standard -EngineType 'V2'

Location Name                Type                     Zone
-------- ----                ----                     ----
East US  testnewkustocluster Microsoft.Kusto/Clusters

La commande ci-dessus met à jour la référence sku du cluster Kusto « testnewkustocluster » trouvée dans le groupe de ressources « testrg ».

Exemple 2 : Mettre à jour un cluster existant par nom

Update-AzKustoCluster -ResourceGroupName testrg -Name testnewkustocluster -KeyVaultPropertyKeyName "TestKey" -KeyVaultPropertyKeyVaultUri "https://testpskeyvault.vault.azure.net" -KeyVaultPropertyKeyVersion "4bd66f0e0d7c403fac80305e0355d982"

Location Name                Type                     Zone
-------- ----                ----                     ----
East US  testnewkustocluster Microsoft.Kusto/Clusters

La commande ci-dessus met à jour le cluster « testnewkustocluster » trouvé dans le groupe de ressources « testrg » avec une clé gérée par le client.

Paramètres

-AcceptedAudience

Audiences acceptées du cluster. Pour construire, consultez la section NOTES pour les propriétés ACCEPTEDAUDIENCE et créer une table de hachage.

Type:IAcceptedAudiences[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowedFqdnList

Liste des noms de domaine complets autorisés (nom de domaine complet) pour la sortie du cluster.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowedIPRangeList

Liste des adresses IP au format CIDR autorisé à se connecter au cluster.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AsJob

Exécuter la commande en tant que travail

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CalloutPolicy

Liste des stratégies de légende pour la sortie du cluster. Pour construire, consultez la section NOTES pour les propriétés CALLOUTPOLICY et créer une table de hachage.

Type:ICalloutPolicy[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Type:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableAutoStop

Valeur booléenne qui indique si le cluster peut être arrêté automatiquement (en raison d’un manque de données ou d’aucune activité pendant de nombreux jours).

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableDiskEncryption

Valeur booléenne qui indique si les disques du cluster sont chiffrés.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableDoubleEncryption

Valeur booléenne qui indique si le double chiffrement est activé.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnablePurge

Valeur booléenne qui indique si les opérations de vidage sont activées.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableStreamingIngest

Valeur booléenne qui indique si l’ingestion de streaming est activée.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EngineType

Type de moteur

Type:EngineType
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdentityType

Type d’identité managée utilisée. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités.

Type:IdentityType
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IdentityUserAssignedIdentity

Liste des identités utilisateur associées au cluster Kusto. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IfMatch

ETag du cluster. Omettez cette valeur pour toujours remplacer le cluster actuel. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

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

Type:IKustoIdentity
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-KeyVaultPropertyKeyName

Nom de la clé du coffre de clés.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyVaultPropertyKeyVaultUri

URI du coffre de clés.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyVaultPropertyKeyVersion

Version de la clé du coffre de clés.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyVaultPropertyUserIdentity

Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LanguageExtensionValue

Liste des extensions de langage. Pour construire, consultez la section NOTES pour les propriétés LANGUAGEEXTENSIONVALUE et créez une table de hachage.

Type:ILanguageExtension[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Emplacement des ressources.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Nom du cluster Kusto.

Type:String
Alias:ClusterName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoWait

Exécuter la commande de manière asynchrone

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OptimizedAutoscaleIsEnabled

Valeur booléenne qui indique si la fonctionnalité de mise à l’échelle automatique optimisée est activée ou non.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OptimizedAutoscaleMaximum

Nombre maximal d’instances autorisées.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OptimizedAutoscaleMinimum

Nombre minimal d’instances autorisées.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OptimizedAutoscaleVersion

Version du modèle défini, par exemple 1.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIPType

Indique le type d’adresse IP publique à créer - IPv4 (valeur par défaut) ou DualStack (IPv4 et IPv6)

Type:PublicIPType
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicNetworkAccess

L’accès au réseau public au cluster est activé par défaut. En cas de désactivation, seule la connexion de point de terminaison privé au cluster est autorisée

Type:PublicNetworkAccess
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RestrictOutboundNetworkAccess

Indique s’il faut restreindre ou non l’accès réseau sortant. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

Type:ClusterNetworkAccessFlag
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkuCapacity

Nombre d’instances du cluster.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkuName

Nom de la référence SKU.

Type:AzureSkuName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SkuTier

Niveau de référence SKU.

Type:AzureSkuTier
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubscriptionId

ID de l’abonnement cible.

Type:String
Position:Named
Valeur par défaut:(Get-AzContext).Subscription.Id
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Balises de ressource.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TrustedExternalTenant

Locataires externes du cluster. Pour construire, consultez la section NOTES pour les propriétés TRUSTEDEXTERNALTENANT et créez une table de hachage.

Type:ITrustedExternalTenant[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualClusterGraduationProperty

Propriétés de graduation de cluster virtuel

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualNetworkConfigurationDataManagementPublicIPId

ID de ressource d’adresse IP publique du service de gestion des données.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualNetworkConfigurationEnginePublicIPId

ID de ressource d’adresse IP publique du service moteur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualNetworkConfigurationState

Lorsqu’il est activé, le cluster est déployé dans le sous-réseau configuré, lorsqu’il est désactivé, il est supprimé du sous-réseau.

Type:VnetState
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VirtualNetworkConfigurationSubnetId

ID de ressource de sous-réseau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Zone

Zones de disponibilité du cluster.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

IKustoIdentity

Sorties

ICluster