Freigeben über

New-AzureRmContainerServiceConfig

  • Referenz
Modul:
AzureRM.Compute

Erstellt ein lokales Konfigurationsobjekt für einen Containerdienst.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

New-AzureRmContainerServiceConfig
   [[-Location] <String>]
   [[-Tag] <Hashtable>]
   [[-OrchestratorType] <ContainerServiceOrchestratorTypes>]
   [[-MasterCount] <Int32>]
   [[-MasterDnsPrefix] <String>]
   [[-AgentPoolProfile] <ContainerServiceAgentPoolProfile[]>]
   [[-WindowsProfileAdminUsername] <String>]
   [[-WindowsProfileAdminPassword] <String>]
   [[-AdminUsername] <String>]
   [[-SshPublicKey] <String[]>]
   [[-VmDiagnosticsEnabled] <Boolean>]
   [-CustomProfileOrchestrator <String>]
   [-ServicePrincipalProfileClientId <String>]
   [-ServicePrincipalProfileSecret <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmContainerServiceConfig erstellt ein lokales Konfigurationsobjekt für einen Containerdienst. Stellen Sie dieses Objekt für das Cmdlet New-AzureRmContainerService bereit, um einen Containerdienst zu erstellen.

Beispiele

Beispiel 1: Erstellen einer Containerdienstkonfiguration

PS C:\> $Container = New-AzureRmContainerServiceConfig -Location "Australia Southeast" -OrchestratorType "DCOS" -MasterDnsPrefix "MasterResourceGroup17" -AdminUsername "AcsLinuxAdmin" -SshPublicKey "<ssh-key>"
PS C:\> $Container | Add-AzureRmContainerServiceAgentPoolProfile -Name "AgentPool01" -VmSize "Standard_A1" -DnsPrefix "APResourceGroup17"

Dieser Befehl erstellt einen Container und speichert ihn dann in der $Container Variablen. Der Befehl gibt verschiedene Einstellungen für die Containerdienstkonfiguration an. Der Befehl übergibt das Konfigurationsobjekt mithilfe des Pipelineoperators an das Cmdlet "Add-AzureRmContainerServiceAgentPoolProfile". Dieses Cmdlet fügt ein Agentpoolprofil hinzu. Geben Sie das Objekt in $Container für den ContainerService-Parameter von New-AzureRmContainerService an.

Parameter

-AdminUsername

Gibt den Namen des Administratorkontos an, das für einen Linux-basierten Containerdienst verwendet werden soll.

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

-AgentPoolProfile

Gibt ein Array von Agentpoolprofilobjekten für den Containerdienst an. Fügen Sie ein Profil mithilfe des Cmdlets "Add-AzureRmContainerServiceAgentPoolProfile" hinzu.

Typ:Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-CustomProfileOrchestrator

Gibt den benutzerdefinierten Profil-Orchestrator an.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Gibt den Speicherort an, an dem der Containerdienst erstellt werden soll.

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

-MasterCount

Gibt die Anzahl der zu erstellenden virtuellen Mastercomputer an.

Typ:Int32
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MasterDnsPrefix

Gibt das DNS-Präfix für den virtuellen Mastercomputer an.

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

-OrchestratorType

Gibt den Orchestratortyp für den Containerdienst an. Die zulässigen Werte für diesen Parameter sind: DCOS und Schwarm.

Typ:Nullable<T>[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes]
Zulässige Werte:Swarm, DCOS, Custom, Kubernetes
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePrincipalProfileClientId

Gibt die Client-ID des Prinzipalprofils an.

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

-ServicePrincipalProfileSecret

Gibt den Prinzipalprofilschlüssel an.

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

-SshPublicKey

Gibt den öffentlichen SSH-Schlüssel für einen Linux-basierten Containerdienst an.

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

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VmDiagnosticsEnabled

Gibt an, ob diese Konfiguration die Diagnose für den virtuellen Containerdienst-Computer ermöglicht.

Typ:Boolean
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, 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

-WindowsProfileAdminPassword

Gibt das Administratorkennwort für einen Containerdienst an, der das Windows-Betriebssystem verwendet.

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

-WindowsProfileAdminUsername

Gibt den Administratorbenutzernamen für einen Containerdienst an, der das Windows-Betriebssystem verwendet.

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

Eingaben

String

Hashtable

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]

String[]

Boolean

Ausgaben

PSContainerService