Set-AksHciConfig

Zusammenfassung

Legt die Konfigurationseinstellungen für den Azure Kubernetes Service Host fest oder aktualisiert sie.

Syntax

Festlegen der Konfiguration für 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]

Description

Legt die Konfigurationseinstellungen für den Azure Kubernetes Service-Host fest. Wenn Sie auf einem 2-4-Knoten Azure Local Cluster oder einem Windows Server 2019 Datacenter-Failovercluster bereitstellen, müssen Sie die -workingDir Parameter angeben-cloudConfigLocation. Bei einem single-node-Windows Server 2019 Datacenter sind alle Parameter optional und auf ihre Standardwerte festgelegt. Zur optimalen Leistung empfehlen wir jedoch die Verwendung eines 2-4-Knotens Azure Local Clusterbereitstellung.

Examples

So stellen Sie einen 2-4-Knotencluster mit DHCP-Netzwerk bereit

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"

So stellen Sie die Bereitstellung mit statischem IP-Netzwerk bereit

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"

So stellen Sie die Bereitstellung mit einem Proxyserver bereit

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 false zum Deaktivieren der automatischen Verteilung als Argument für diesen Parameter. 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.

-mode

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 lautet 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. Standardeinstellung %systemdrive%\programdata\wssdagent für alle Bereitstellungen.

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 eine Liste der verfügbaren VM-Größen aus, um Get-AksHciVmSizeeine Liste der 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 ÖFFENTLICHEN SSH-Schlüsseldatei. Mit diesem öffentlichen Schlüssel 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 Start der MAC-Adresse des MAC-Pools an, die 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 nützlich, wenn Sie eine Anforderung haben, dass die virtuellen Computer bestimmte MAC-Adressen haben. Der Standardwert lautet 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, die 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 nützlich, wenn Sie eine Anforderung haben, dass die virtuellen Computer bestimmte MAC-Adressen haben. Der Standardwert lautet 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 lautet 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, die Standardeinstellung 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, die Standardeinstellung 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 Knoten-Agents für ihren Autorisierungsport verwenden sollten. Standardwert ist 45001. Es wird nicht empfohlen, die Standardeinstellung 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, die Standardeinstellung 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. Standardwert ist 65000. Es wird nicht empfohlen, die Standardeinstellung 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, die Standardeinstellung 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 Microsoft Betriebenen Cloudstandortnamen bereit. Der Standardname ist MocLocation. Es wird nicht empfohlen, die Standardeinstellung 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. Es wird nicht empfohlen, diese Einstellung zu verwenden.

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. Es wird nicht empfohlen, diese Einstellung zu verwenden.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-unsicher

Stellt AKS-Hybridkomponenten wie Cloud-Agent und Knoten-Agent(en) im unsicheren Modus bereit (keine TLS-gesicherten Verbindungen). Es wird nicht empfohlen, den unsicheren Modus in Produktionsumgebungen zu verwenden.

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 Kennzeichen, wenn Sie alle verfügbaren Updates überspringen möchten. Es wird nicht empfohlen, diese Einstellung zu verwenden.

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 bis zu einer Stunde auf einigen Systemen dauern. 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. Um dieses Problem zu umgehen, versuchen Sie, dieses Kennzeichen zu verwenden. Die -forceDnsReplication Kennzeichnung ist kein garantierter Fix. 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. Es wird nicht empfohlen, diese Einstellung zu verwenden.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Nächste Schritte

AksHci PowerShell-Referenz

Feedback

War diese Seite hilfreich?

Last updated on 2023-04-11