Set-AksHciConfig

  • Artikel

Synopsis

Anger eller uppdaterar konfigurationsinställningarna för Azure Kubernetes Service-värden.

Syntax

Ange konfiguration för värd

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

Anger konfigurationsinställningarna för Azure Kubernetes Service-värden. Om du distribuerar på ett Azure Stack HCI-kluster med 2–4 noder eller ett Windows Server 2019 Datacenter-redundanskluster måste du ange parametrarna -workingDir och -cloudConfigLocation . För ett Windows Server 2019 Datacenter med en nod är alla parametrar valfria och inställda på deras standardvärden. För optimala prestanda rekommenderar vi dock att du använder en Azure Stack HCI-klusterdistribution med 2–4 noder.

Exempel

Distribuera på ett 2-4-nodkluster med DHCP-nätverk

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"

Distribuera med statiska IP-nätverk

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"

Distribuera med en 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"

Parametrar

-imageDir

Sökvägen till katalogen där AKS-hybrid lagrar sina VHD-avbildningar. Den här parametern krävs. Sökvägen måste peka på en delad lagringssökväg, till exempel C:\ClusterStorage\Volume2\ImageStore, eller en SMB-resurs, till exempel \\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

En arbetskatalog för modulen som ska användas för att lagra små filer. Den här parametern krävs. Sökvägen måste peka på en delad lagringssökväg, till exempel c:\ClusterStorage\Volume2\ImageStore.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\AksHci
Accept pipeline input: False
Accept wildcard characters: False

-cloudConfigLocation

Den plats där molnagenten lagrar sin konfiguration. Den här parametern krävs. Sökvägen måste peka på en delad lagringssökväg, till exempel C:\ClusterStorage\Volume2\ImageStore, eller en SMB-resurs, \\FileShare\ImageStoretill exempel . Platsen måste finnas på en resurs med hög tillgänglighet så att lagringen alltid är tillgänglig.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False

-vnet

Namnet på AksHciNetworkSetting-objektet som skapades med New-AksHciNetworkSetting kommandot .

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

Gör att du kan inaktivera automatisk distribution av VM-data på dina klusterdelade volymer (CSV). Om du vill inaktivera automatisk distribution använder du false som argument för den här parametern. Om automatisk distribution är inaktiverat används endast den CSV som du har valt för imageDir . Standardvärdet är true.

Type: System.Boolean
Parameter Sets: (All)
Aliases:

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

-offlineLadda ned

Anropar offlinenedladdning under Install-AksHci. Du måste också köra Enable-AksHciOfflineDownload. Den här flaggan används tillsammans med parametern -stagingShare .

Type: System.Boolean
Parameter Sets: (All)
Aliases:

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

-offsiteTransferCompleted

Anger att distributionen ska använda artefakter som laddats ned från plats och överförts till distributionsservern under Install-AksHci. Den här flaggan används tillsammans med parametern -offlineDownload och -stagingShare .

-Läge

Nedladdningsläget som du vill använda för offlinenedladdning. Använd om du vill ha minimum de minsta avbildningarna för AKS-hybriddistribution. Det här alternativet innehåller nödvändiga Linux-avbildningar och endast den Kubernetes-avbildning som krävs. Använd om du vill ha full alla avbildningar för AKS-hybriddistribution. Det här alternativet innehåller alla Linux- och Windows-avbildningar och alla Kubernetes-avbildningar som stöds. Använd den här parametern tillsammans med parametern -offlineDownload . Standardvärdet är full.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-stagingShare

Den lokala sökvägen dit du vill att bilderna ska laddas ned. Använd tillsammans med parametern offlineDownload .

Type: System.String
Parameter Sets: (All)
Aliases:

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

-nodeConfigLocation

Den plats där nodagenterna lagrar sin konfiguration. Varje nod har en nodagent, så dess konfiguration är lokal för den noden. Den här platsen måste vara en lokal sökväg. Standardvärdet är %systemdrive%\programdata\wssdagent för alla distributioner.

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

Storleken på den virtuella dator som ska skapas för kontrollplanet. Om du vill hämta en lista över tillgängliga VM-storlekar kör du Get-AksHciVmSize.

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

Sökväg till en offentlig SSH-nyckelfil. Med den här offentliga nyckeln kan du logga in på någon av de virtuella datorer som skapats av AKS-hybriddistributionen. Om du har en egen offentlig SSH-nyckel skickar du dess plats här. Om ingen nyckel anges letar vi efter en under %systemdrive%\akshci\.ssh\akshci_rsa.pub. Om filen inte finns genereras ett SSH-nyckelpar på den här platsen och används.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-macPoolStarta

Anger början av MAC-adressen för den MAC-pool som du vill använda för den Azure Kubernetes Service virtuella värddatorn. Syntaxen för MAC-adressen kräver att den minsta signifikanta biten av den första byten alltid ska vara 0, och den första byten ska alltid vara ett jämnt tal (det vill: 00, 02, 04, 06...). En typisk MAC-adress kan se ut så här: 02:1E:2B:78:00:00. Använd MAC-pooler för långvariga distributioner så att tilldelade MAC-adresser är konsekventa. MAC-pooler är användbara om du har ett krav på att de virtuella datorerna har specifika MAC-adresser. Standardvärdet är None.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-macPoolEnd

Anger slutet på MAC-adressen för den MAC-pool som du vill använda för den Azure Kubernetes Service virtuella värddatorn. Syntaxen för MAC-adressen kräver att den minsta signifikanta biten av den första byten alltid ska vara 0, och den första byten ska alltid vara ett jämnt tal (det vill: 00, 02, 04, 06...). Den första byte av den adress som skickas som -macPoolEnd ska vara samma som den första byte av adressen som skickas som -macPoolStart. Använd MAC-pooler för långvariga distributioner så att tilldelade MAC-adresser är konsekventa. MAC-pooler är användbara om du har ett krav på att de virtuella datorerna har specifika MAC-adresser. Standardvärdet är None.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-proxyInställningar

Proxyobjektet som skapats med New-AksHciProxySetting.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-cloudServiceCidr

Tillhandahåller ett statiskt IP-/nätverksprefix som ska tilldelas till MOC CloudAgent-tjänsten. Det här värdet ska anges med CIDR-formatet. till exempel 192.168.1.2/16. Du kanske vill ange den här parametern för att säkerställa att allt som är viktigt i nätverket alltid är tillgängligt, eftersom IP-adressen inte ändras. Standardvärdet är None.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-Version

Den version av AKS-hybrid som du vill distribuera. Standardvärdet är den senaste versionen. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-nodeAgentPort

TCP/IP-portnumret som nodagenterna ska lyssna på, vilket är standardvärdet 45000. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.Int32
Parameter Sets: (All)
Aliases:

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

-nodeAgentAuthorizerPort

TCP/IP-portnumret som nodagenterna ska använda för sin auktoriseringsport. Standardvärdet är 45001. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.Int32
Parameter Sets: (All)
Aliases:

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

-cloudAgentPort

TCP/IP-portnumret som molnagenten ska lyssna på. Standardvärdet är 55000. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.Int32
Parameter Sets: (All)
Aliases:

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

-cloudAgentAuthorizerPort

TCP/IP-portnumret som molnagenten ska använda för sin auktoriseringsport. Standardvärdet är 65 000. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.Int32
Parameter Sets: (All)
Aliases:

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

-clusterRoleName

Anger namnet som ska användas när du skapar molnagenten som en allmän tjänst i klustret. Den här parametern har som standard ett unikt namn med prefixet ca- och ett GUID-suffix. Vi rekommenderar inte att du ändrar standardinställningen.

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

Tillhandahåller ett anpassat namn för Microsoft-drivna molnplatser. Standardnamnet är MocLocation. Vi rekommenderar inte att du ändrar standardinställningen.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-skipHostLimitChecks

Begär att skriptet hoppar över alla kontroller för att bekräfta att minne och diskutrymme är tillgängligt innan distributionen kan fortsätta. Vi rekommenderar inte att du använder den här inställningen.

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

Begär att skriptet hoppar över alla kontroller för att bekräfta fjärrkommunikationsfunktioner till både lokala noder och fjärrnoder. Vi rekommenderar inte att du använder den här inställningen.

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

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

-Osäkra

Distribuerar AKS-hybridkomponenter, till exempel molnagenter och nodagenter, i osäkert läge (inga TLS-skyddade anslutningar). Vi rekommenderar inte att du använder osäkert läge i produktionsmiljöer.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-skipUpdates

Använd den här flaggan om du vill hoppa över alla tillgängliga uppdateringar. Vi rekommenderar inte att du använder den här inställningen.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-forceDnsReplication

DNS-replikeringen kan ta upp till en timme på vissa system. Detta gör att distributionen blir långsam. Om det här problemet uppstår ser du att det Install-AksHci har fastnat i en loop. Försök att använda den här flaggan för att komma förbi det här problemet. Flaggan -forceDnsReplication är inte en garanterad korrigering. Om logiken bakom flaggan misslyckas döljs felet och kommandot fortsätter som om flaggan inte angavs.

Type: System.String
Parameter Sets: (All)
Aliases:

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

-skipValidationChecks

Använd den här flaggan om du vill hoppa över verifieringskontrollerna av miljöinfrastrukturen och användarindata för konfiguration. Dessa kontroller belyser potentiella problem som kan åtgärdas innan du fortsätter med installationen. Vi rekommenderar inte att du använder den här inställningen.

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ästa steg

AksHci PowerShell-referens