Set-AksHciConfig

Übersicht

Legt die Konfigurationseinstellungen für den Azure Kubernetes Service Host 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 Service Host fest. Wenn Sie die Bereitstellung auf einem Azure Stack HCI-Cluster mit 2 bis 4 Knoten oder einem Windows Server 2019 Datacenter Failovercluster vornehmen, müssen Sie die Parameter -workingDir und -cloudConfigLocation angeben. Für ein Windows Server 2019 Datacenter mit einem einzelnen Knoten sind alle Parameter optional und auf ihre Standardwerte festgelegt. Zur Erzielung einer optimalen Leistung empfehlen wir Ihnen aber, die Bereitstellung eines Azure Stack HCI-Clusters mit zwei bis vier Knoten zu verwenden.

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 zu dem Verzeichnis, in dem AKS-Hybrid die VHD-Images speichert. Dieser Parameter ist erforderlich. Der Pfad muss auf einen freigegebenen Speicherpfad, z C:\ClusterStorage\Volume2\ImageStore. B. , oder auf eine SMB-Freigabe wie verweisen \\FileShare\ImageStore.

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, z C:\ClusterStorage\Volume2\ImageStore. B. , oder auf eine SMB-Freigabe wie \\FileShare\ImageStoreverweisen. Der Speicherort muss sich in einer hochverfügbaren Freigabe befinden, damit immer auf den Speicher zugegriffen werden kann.

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 AksHciNetworkSetting-Objekts , das mit dem New-AksHciNetworkSetting Befehl erstellt wurde.

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

Ermöglicht ihnen das Deaktivieren der automatischen Verteilung von VM-Daten auf Ihren freigegebenen Clustervolumes (CSV). 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

-offlineHerunterladen

Ruft den Offlinedownload während install-AksHci auf. Sie müssen auch Enable-AksHciOfflineDownload ausführen. Dieses Flag 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 so fest, dass Artefakte verwendet werden, die außerhalb des Standorts heruntergeladen und während der Installation von AksHci auf den Bereitstellungsserver übertragen werden. Dieses Flag wird zusammen mit dem -offlineDownload Parameter und -stagingShare verwendet.

-Modus

Der Downloadmodus, den Sie für den Offlinedownload verwenden möchten. Verwenden Sie minimum , wenn Sie die Mindestimages für die AKS-Hybridbereitstellung benötigen. Diese Option umfasst die erforderlichen Linux-Images und nur das erforderliche Kubernetes-Image. Verwenden Sie full , wenn Sie alle Images für die AKS-Hybridbereitstellung verwenden möchten. Diese Option umfasst alle Linux- und Windows-Images sowie 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 dem die Bilder heruntergeladen werden sollen. Verwenden Sie zusammen mit dem offlineDownload -Parameter.

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. Mit diesem öffentlichen Schlüssel können Sie sich bei allen VMs anmelden, die von der AKS-Hybridbereitstellung erstellt wurden. Wenn Sie über einen eigenen öffentlichen SSH-Schlüssel verfügen, übergeben Sie den Speicherort 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 am wenigsten 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 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, den Sie für die Azure Kubernetes Service-Host-VM verwenden möchten. Bei der Syntax für die MAC-Adresse ist es erforderlich, dass das unwichtigste Bit des ersten Bytes immer „0“ ist, und das erste Byte sollte immer eine gerade Zahl sein (d. h. 00, 02, 04, 06...). Das erste Byte der Adresse, die als -macPoolEnd übergeben wird, sollte dem ersten Byte der Adresse entsprechen, die als -macPoolStart übergeben wird. 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 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 im CIDR-Format angegeben werden. Beispiel: 192.168.1.2/16. Sie können diesen Parameter angeben, um sicherzustellen, dass immer auf alle wichtigen Elemente im Netzwerk 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 von AKS-Hybrid, 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, an der Knoten-Agents lauschen sollen( standardwert: 45000).  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, an der 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 soll. 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 verwendet werden soll, wenn der Cloud-Agent als generischer Dienst innerhalb des Clusters erstellt wird. 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 knoten 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(s) 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 aufgetreten ist, sehen Sie, dass Install-AksHci in einer Schleife hängen bleibt. 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üfungen der Umgebungsinfrastruktur und der Benutzerkonfigurationseingabe überspringen möchten. Bei diesen Überprüfungen werden potenzielle Probleme hervorgehoben, die vor dem Fortsetzen der Installation behoben werden müssen. 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

Nächste Schritte

PowerShell-Referenz für AksHci