Set-AksHciConfig
Übersicht
Legt die Konfigurationseinstellungen für den Azure Kubernetes-Diensthost fest oder aktualisiert sie.
Syntax
Festlegen der Konfiguration für den Host
Set-AksHciConfig -imageDir <String>
-workingDir <String>
-cloudConfigLocation <String>
-vnet <Virtual Network>
[-createAutoConfigContainers {true, false}]
[-offlineDownload]
[-offsiteTransferCompleted]
[-mode {minimum, full}]
[-stagingShare <String>]
[-nodeConfigLocation <String>]
[-controlPlaneVmSize <VmSize>]
[-sshPublicKey <String>]
[-macPoolStart <String>]
[-macPoolEnd <String>]
[-proxySettings <ProxySettings>]
[-cloudServiceCidr <String>]
[-version <String>]
[-nodeAgentPort <int>]
[-nodeAgentAuthorizerPort <int>]
[-cloudAgentPort <int>]
[-cloudAgentAuthorizerPort <int>]
[-clusterRoleName <String>]
[-cloudLocation <String>]
[-concurrentDownloads <int>]
[-skipHostLimitChecks]
[-skipRemotingChecks]
[-skipValidationChecks]
[-insecure]
[-skipUpdates]
[-forceDnsReplication]
Beschreibung
Legt die Konfigurationseinstellungen für den Azure Kubernetes-Diensthost fest. Wenn Sie eine Bereitstellung auf einem 2-4-Knoten azure Local Cluster oder einem Windows Server 2019 Datacenter-Failovercluster durchführen, müssen Sie die -workingDir Parameter angeben -cloudConfigLocation . Für ein Einzelknoten-Windows Server 2019 Datacenter sind alle Parameter optional und auf ihre Standardwerte festgelegt. Zur optimalen Leistung empfehlen wir jedoch die Verwendung einer Azure Local Cluster-Bereitstellung mit 2 bis 4 Knoten.
Beispiele
Ausführen der Bereitstellung auf einem Cluster mit 2 bis 4 Knoten mit einem DHCP-Netzwerk
PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Ausführen der Bereitstellung mit einem statischen IP-Netzwerk
PS C:\> $vnet = New-AksHciNetworkSetting -name newNetwork -vswitchName "DefaultSwitch" -k8snodeippoolstart "172.16.10.0" -k8snodeippoolend "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipaddressprefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsservers "172.16.0.1"
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Ausführen der Bereitstellung mit einem Proxyserver
PS C:\> $proxySettings = New-AksHciProxySetting -name "corpProxy" -http http://contosoproxy:8080 -https https://contosoproxy:8443 -noProxy localhost,127.0.0.1,.svc,10.96.0.0/12,10.244.0.0/16 -credential $proxyCredential
Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -proxySetting $proxySettings -vnet $vnet -cloudservicecidr "172.16.10.10/16"
Parameter
-imageDir
Der Pfad zum Verzeichnis, in dem AKS Hybrid seine VHD-Images speichert. Dieser Parameter ist erforderlich. Der Pfad muss auf einen freigegebenen Speicherpfad verweisen, z C:\ClusterStorage\Volume2\ImageStore. B. auf eine SMB-Freigabe, z \\FileShare\ImageStore. B. .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\AksHciImageStore
Accept pipeline input: False
Accept wildcard characters: False
-workingDir
Ein Arbeitsverzeichnis für das Modul, das zum Speichern kleiner Dateien verwendet werden soll. Dieser Parameter ist erforderlich. Der Pfad muss auf einen freigegebenen Speicherpfad verweisen, z c:\ClusterStorage\Volume2\ImageStore. B. .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False
-cloudConfigLocation
Der Speicherort, an dem der Cloud-Agent seine Konfiguration speichert. Dieser Parameter ist erforderlich. Der Pfad muss auf einen freigegebenen Speicherpfad verweisen, z C:\ClusterStorage\Volume2\ImageStore. B. auf eine SMB-Freigabe wie \\FileShare\ImageStorez. B. . Der Speicherort muss sich auf einer hoch verfügbaren Freigabe befinden, damit der Speicher immer zugänglich ist.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
-vnet
Der Name des mit dem New-AksHciNetworkSetting Befehl erstellten AksHciNetworkSetting-Objekts.
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Ermöglicht es Ihnen, die automatische Verteilung von VM-Daten auf Ihren freigegebenen Clustervolumes (CSV) zu deaktivieren. Verwenden Sie falseals Argument für diesen Parameter, um die automatische Verteilung zu deaktivieren. Wenn die automatische Verteilung deaktiviert ist, wird nur die csv-Datei verwendet, für imageDir die Sie ausgewählt haben. Der Standardwert ist true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Ruft den Offlinedownload während der Installation-AksHci auf. Sie müssen auch Enable-AksHciOfflineDownload ausführen. Dieses Kennzeichen wird zusammen mit dem -stagingShare Parameter verwendet.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Legt die Bereitstellung fest, um Artefakte zu verwenden, die außerhalb des Standorts heruntergeladen und während der Installation-AksHci auf den Bereitstellungsserver übertragen werden. Dieses Flag wird zusammen mit dem Parameter und -stagingShare dem -offlineDownload Parameter verwendet.
-Modus
Der Downloadmodus, den Sie für den Offlinedownload verwenden möchten. Verwenden Sie minimum diese Möglichkeit, wenn Sie die Mindestimages für die AKS-Hybridbereitstellung benötigen. Diese Option enthält die erforderlichen Linux-Images und nur das erforderliche Kubernetes-Image. Verwenden Sie full diese Möglichkeit, wenn alle Images für die AKS-Hybridbereitstellung verwendet werden sollen. Diese Option umfasst alle Linux- und Windows-Images und alle unterstützten Kubernetes-Images. Verwenden Sie diesen Parameter zusammen mit dem -offlineDownload Parameter. Der Standardwert ist full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Der lokale Pfad zu der Stelle, an der die Bilder heruntergeladen werden sollen. Wird zusammen mit dem offlineDownload Parameter verwendet.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Der Speicherort, an dem die Knoten-Agents ihre Konfiguration speichern. Jeder Knoten verfügt über einen Knoten-Agent, sodass seine Konfiguration für diesen Knoten lokal ist. Dieser Speicherort muss ein lokaler Pfad sein. Der Standardwert ist für alle Bereitstellungen %systemdrive%\programdata\wssdagent.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: %systemdrive%\programdata\wssdagent
Accept pipeline input: False
Accept wildcard characters: False
-controlPlaneVmSize
Die Größe des virtuellen Computers, der für die Steuerungsebene erstellt werden soll. Führen Sie Get-AksHciVmSize aus, um eine Liste mit den verfügbaren VM-Größen abzurufen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Standard_A4_V2
Accept pipeline input: False
Accept wildcard characters: False
-sshPublicKey
Pfad zu einer Datei mit einem öffentlichen SSH-Schlüssel. Mithilfe dieses öffentlichen Schlüssels können Sie sich bei allen virtuellen Computern anmelden, die von der AKS-Hybridbereitstellung erstellt wurden. Wenn Sie über ihren eigenen öffentlichen SSH-Schlüssel verfügen, übergeben Sie seinen Standort hier. Wenn kein Schlüssel angegeben wird, suchen wir unter %systemdrive%\akshci\.ssh\akshci_rsa".pub" nach einem Schlüssel. Wenn die Datei nicht vorhanden ist, wird an diesem Speicherort ein SSH-Schlüsselpaar generiert und verwendet.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Gibt den Beginn der MAC-Adresse des MAC-Pools an, den Sie für die Azure Kubernetes Service-Host-VM verwenden möchten. Die Syntax für die MAC-Adresse erfordert, dass das kleinste signifikante Bit des ersten Byte immer 0 sein sollte, und das erste Byte sollte immer eine gerade Zahl sein (d. h. 00, 02, 04, 06...). Eine typische MAC-Adresse kann wie folgt aussehen: 02:1E:2B:78:00:00. Verwenden Sie MAC-Pools für langlebige Bereitstellungen, damit die zugewiesenen MAC-Adressen konsistent sind. MAC-Pools sind hilfreich, wenn eine Anforderung verlangt, dass die VMs über bestimmte MAC-Adressen verfügen. Der Standardwert ist None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Gibt das Ende der MAC-Adresse des MAC-Pools an, den Sie für die Azure Kubernetes Service-Host-VM verwenden möchten. Die Syntax für die MAC-Adresse erfordert, dass das kleinste signifikante Bit des ersten Byte immer 0 sein sollte, und das erste Byte sollte immer eine gerade Zahl sein (d. h. 00, 02, 04, 06...). Das erste Byte der Adresse, die als die adresse übergeben wird -macPoolEnd , sollte mit dem ersten Byte der Adresse übereinstimmen, die als " -macPoolStart. Verwenden Sie MAC-Pools für langlebige Bereitstellungen, damit die zugewiesenen MAC-Adressen konsistent sind. MAC-Pools sind hilfreich, wenn eine Anforderung verlangt, dass die VMs über bestimmte MAC-Adressen verfügen. Der Standardwert ist None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Das Proxyobjekt, das mit New-AksHciProxySetting erstellt wurde.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-cloudServiceCidr
Stellt ein statisches IP-/Netzwerkpräfix bereit, das dem MOC CloudAgent-Dienst zugewiesen werden soll. Dieser Wert sollte mit dem CIDR-Format bereitgestellt werden; Beispiel: 192.168.1.2/16. Möglicherweise möchten Sie diesen Parameter angeben, um sicherzustellen, dass auf alle wichtigen Elemente im Netzwerk immer zugegriffen werden kann, da sich die IP-Adresse nicht ändert. Der Standardwert ist None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-version
Die Version der AKS-Hybridbereitstellung, die Sie bereitstellen möchten. Der Standardwert ist die neueste Version. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Die TCP/IP-Portnummer, auf der Knoten-Agents lauschen sollen, was standardmäßig auf 45000 festgelegt ist. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Die TCP/IP-Portnummer, die von Knoten-Agents für ihren Autorisierungsport verwendet werden soll. Der Standardwert ist „45001“. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Die TCP/IP-Portnummer, auf die der Cloud-Agent lauschen soll. Der Standardwert ist 55000. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Die TCP/IP-Portnummer, die der Cloud-Agent für seinen Autorisierungsport verwenden sollte. Der Standardwert ist 65000. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Gibt den Namen an, der beim Erstellen des Cloud-Agents als generischer Dienst innerhalb des Clusters verwendet werden soll. Dieser Parameter verwendet standardmäßig einen eindeutigen Namen mit dem Präfix ca- und einem GUID-Suffix. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: A unique name with a prefix of ca- and a guid suffix
Accept pipeline input: False
Accept wildcard characters: False
-cloudLocation
Stellt einen benutzerdefinierten, von Microsoft betriebenen Cloudspeicherortnamen bereit. Der Standardname ist MocLocation. Es wird nicht empfohlen, den Standardwert zu ändern.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Fordert an, dass das Skript alle Überprüfungen überspringt, um zu bestätigen, dass Arbeitsspeicher und Speicherplatz verfügbar sind, bevor die Bereitstellung fortgesetzt werden kann. Die Verwendung dieser Einstellung wird nicht empfohlen.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipRemotingChecks
Fordert an, dass das Skript alle Überprüfungen überspringt, um Die Remotingfunktionen sowohl auf lokalen als auch auf Remoteknoten zu bestätigen. Die Verwendung dieser Einstellung wird nicht empfohlen.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-insecure
Stellt AKS-Hybridkomponenten wie Cloud-Agent und Knoten-Agent(en) im unsicheren Modus bereit (keine TLS-gesicherten Verbindungen). Wir raten davon ab, den ungeschützten Modus in Produktionsumgebungen zu nutzen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Verwenden Sie dieses Flag, wenn Sie alle verfügbaren Updates überspringen möchten. Die Verwendung dieser Einstellung wird nicht empfohlen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
Die DNS-Replikation kann auf einigen Systemen bis zu eine Stunde in Anspruch nehmen. Dies führt dazu, dass die Bereitstellung langsam ist. Wenn dieses Problem auftritt, sehen Sie, dass Install-AksHci sie in einer Schleife hängen geblieben ist. Versuchen Sie, dieses Flag zu verwenden, um das Problem zu beheben. Es ist nicht sichergestellt, dass die Behebung mit dem Flag -forceDnsReplication erfolgreich ist. Wenn die Logik hinter dem Flag fehlschlägt, wird der Fehler ausgeblendet, und der Befehl wird fortgesetzt, als ob das Flag nicht bereitgestellt wurde.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Verwenden Sie dieses Flag, wenn Sie die Überprüfungsprüfungen der Umgebungsinfrastruktur und der Benutzerkonfigurationseingabe überspringen möchten. Bei diesen Prüfungen werden potenzielle Probleme hervorgehoben, die behoben werden müssen, bevor Sie mit der Installation fortfahren. Die Verwendung dieser Einstellung wird nicht empfohlen.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False