Freigeben über


New-AzKustoCluster

Erstellen oder Aktualisieren eines Kusto-Clusters.

Syntax

New-AzKustoCluster
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   -Location <String>
   -SkuName <AzureSkuName>
   -SkuTier <AzureSkuTier>
   [-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[]>]
   [-OptimizedAutoscaleIsEnabled]
   [-OptimizedAutoscaleMaximum <Int32>]
   [-OptimizedAutoscaleMinimum <Int32>]
   [-OptimizedAutoscaleVersion <Int32>]
   [-PublicIPType <PublicIPType>]
   [-PublicNetworkAccess <PublicNetworkAccess>]
   [-RestrictOutboundNetworkAccess <ClusterNetworkAccessFlag>]
   [-SkuCapacity <Int32>]
   [-Tag <Hashtable>]
   [-TrustedExternalTenant <ITrustedExternalTenant[]>]
   [-VirtualClusterGraduationProperty <String>]
   [-VirtualNetworkConfigurationDataManagementPublicIPId <String>]
   [-VirtualNetworkConfigurationEnginePublicIPId <String>]
   [-VirtualNetworkConfigurationState <VnetState>]
   [-VirtualNetworkConfigurationSubnetId <String>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellen oder Aktualisieren eines Kusto-Clusters.

Beispiele

Beispiel 1: Erstellen eines neuen Kusto-Clusters

New-AzKustoCluster -ResourceGroupName testrg -Name testnewkustocluster -Location 'East US' -SkuName Standard_D11_v2 -SkuTier Standard -EnableDoubleEncryption -EngineType 'V2'

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

Mit dem obigen Befehl wird ein neuer Kusto-Cluster namens "testnewkustocluster" in der Ressourcengruppe "testrg" erstellt.

Parameter

-AcceptedAudience

Die akzeptierten Zielgruppen des Clusters. Informationen zum Erstellen finden Sie im ABSCHNITT NOTES für ACCEPTEDAUDIENCE-Eigenschaften und erstellen eine Hashtabelle.

Typ:Microsoft.Azure.PowerShell.Cmdlets.Kusto.Models.Api20240413.IAcceptedAudiences[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowedFqdnList

Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllowedIPRangeList

Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CalloutPolicy

Liste der Legendenrichtlinien für den Ausgang von Cluster. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für CALLOUTPOLICY-Eigenschaften und erstellen eine Hashtabelle.

Typ:Microsoft.Azure.PowerShell.Cmdlets.Kusto.Models.Api20240413.ICalloutPolicy[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableAutoStop

Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage).

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDiskEncryption

Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDoubleEncryption

Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnablePurge

Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableStreamingIngest

Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EngineType

Der Modultyp

Typ:EngineType
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdentityType

Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten.

Typ:IdentityType
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IdentityUserAssignedIdentity

Die Liste der Benutzeridentitäten, die dem Kusto-Cluster zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IfMatch

Das ETag des Clusters. Lassen Sie diesen Wert aus, um den aktuellen Cluster immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IfNoneMatch

Legen Sie auf '*' fest, damit ein neuer Cluster erstellt werden kann, aber um zu verhindern, dass ein vorhandener Cluster aktualisiert wird. Andere Werte führen zu einer Fehlerantwort von 412 Vorbedingung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyName

Der Name des Schlüsseltresorschlüssels.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyVaultUri

Der URI des Schlüsseltresors.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyVersion

Die Version des Schlüsseltresorschlüssels.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyUserIdentity

Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LanguageExtensionValue

Die Liste der Spracherweiterungen. Informationen zum Erstellen finden Sie im ABSCHNITT "NOTES" für LANGUAGEEXTENSIONVALUE-Eigenschaften und erstellen eine Hashtabelle.

Typ:Microsoft.Azure.PowerShell.Cmdlets.Kusto.Models.Api20240413.ILanguageExtension[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Der geografische Standort, an dem sich die Ressource befindet

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name des Kusto-Clusters.

Typ:String
Aliase:ClusterName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OptimizedAutoscaleIsEnabled

Ein boolescher Wert, der angibt, ob das optimierte Autoskalen-Feature aktiviert ist oder nicht.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OptimizedAutoscaleMaximum

Maximale Anzahl zulässiger Instanzen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OptimizedAutoscaleMinimum

Anzahl der zulässigen Mindestinstanzen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OptimizedAutoscaleVersion

Die Version der definierten Vorlage, z. B. 1.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPType

Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6)

Typ:PublicIPType
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicNetworkAccess

Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig.

Typ:PublicNetworkAccess
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RestrictOutboundNetworkAccess

Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein.

Typ:ClusterNetworkAccessFlag
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkuCapacity

Die Anzahl der Instanzen des Clusters.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkuName

SKU-Name.

Typ:AzureSkuName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkuTier

SKU-Ebene.

Typ:AzureSkuTier
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Die ID des Zielabonnements.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Ressourcentags.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TrustedExternalTenant

Die externen Mandanten des Clusters. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für TRUSTEDEXTERNALTENANT-Eigenschaften und erstellen eine Hashtabelle.

Typ:Microsoft.Azure.PowerShell.Cmdlets.Kusto.Models.Api20240413.ITrustedExternalTenant[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualClusterGraduationProperty

Virtuelle Cluster Graduierungseigenschaften

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkConfigurationDataManagementPublicIPId

Die Dienst-ID der öffentlichen IP-Adresse der Datenverwaltung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkConfigurationEnginePublicIPId

Die öffentliche IP-Adressressourcen-ID des Moduldiensts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkConfigurationState

Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt.

Typ:VnetState
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkConfigurationSubnetId

Die Subnetzressourcen-ID.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Zone

Die Verfügbarkeitszonen des Clusters.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Microsoft.Azure.PowerShell.Cmdlets.Kusto.Models.Api20240413.ICluster