Set-AksHciConfig
Samenvatting
Hiermee stelt u de configuratie-instellingen voor de Azure Kubernetes Service-host in of werkt u deze bij.
Syntaxis
Configuratie instellen voor 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]
Beschrijving
Hiermee stelt u de configuratie-instellingen voor de Azure Kubernetes Service-host in. Als u implementeert op een lokaal Azure-cluster met 2-4 knooppunten of een Failovercluster van Windows Server 2019 Datacenter, moet u de -workingDir en -cloudConfigLocation parameters opgeven. Voor een Windows Server 2019 Datacenter met één knooppunt zijn alle parameters optioneel en ingesteld op de standaardwaarden. Voor optimale prestaties raden we u echter aan een azure-clusterimplementatie van 2-4 knooppunten te gebruiken.
Voorbeelden
Implementeren op een cluster met 2-4 knooppunten met DHCP-netwerken
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"
Implementeren met statische IP-netwerken
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"
Implementeren met een 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"
Parameters
-imageDir
Het pad naar de map waarin AKS hybride de VHD-installatiekopieën opslaat. Deze parameter is vereist. Het pad moet verwijzen naar een gedeeld opslagpad, zoals C:\ClusterStorage\Volume2\ImageStore, of een SMB-share, zoals \\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
Een werkmap voor de module die moet worden gebruikt voor het opslaan van kleine bestanden. Deze parameter is vereist. Het pad moet verwijzen naar een gedeeld opslagpad, zoals 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
De locatie waar de cloudagent de configuratie opslaat. Deze parameter is vereist. Het pad moet verwijzen naar een gedeeld opslagpad, zoals C:\ClusterStorage\Volume2\ImageStoreof een SMB-share, zoals \\FileShare\ImageStore. De locatie moet zich op een maximaal beschikbare share bevinden, zodat de opslag altijd toegankelijk is.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
vnet-
De naam van het AksHciNetworkSetting-object dat is gemaakt met de New-AksHciNetworkSetting opdracht.
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Hiermee kunt u automatische distributie van VM-gegevens op gedeelde clustervolumes (CSV) uitschakelen. Als u automatische distributie wilt uitschakelen, gebruikt false u dit als argument voor deze parameter. Als automatische distributie is uitgeschakeld, wordt alleen het CSV-bestand gebruikt dat u hebt imageDir geselecteerd. De standaardwaarde is true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Roept offline downloaden aan tijdens Install-AksHci. U moet ook Enable-AksHciOfflineDownload uitvoeren. Deze vlag wordt samen met de -stagingShare parameter gebruikt.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Hiermee stelt u de implementatie in voor het gebruik van artefacten die offsite zijn gedownload en overgedragen naar de implementatieserver tijdens install-AksHci. Deze vlag wordt samen met de -offlineDownload en -stagingShare parameter gebruikt.
-wijze
De downloadmodus die u wilt gebruiken voor offline downloaden. Gebruik minimum deze optie als u de minimale installatiekopieën voor hybride AKS-implementatie wilt. Deze optie bevat de vereiste Linux-installatiekopieën en alleen de vereiste Kubernetes-installatiekopieën. Gebruik full deze optie als u alle installatiekopieën voor hybride AKS-implementatie wilt. Deze optie omvat alle Linux- en Windows-installatiekopieën en alle ondersteunde Kubernetes-installatiekopieën. Gebruik deze parameter in combinatie met de -offlineDownload parameter. De standaardwaarde is full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Het lokale pad naar de locatie waar u de afbeeldingen wilt downloaden. Gebruik deze in combinatie met de 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
De locatie waar de knooppuntagents hun configuratie opslaan. Elk knooppunt heeft een knooppuntagent, dus de configuratie is lokaal voor dat knooppunt. Deze locatie moet een lokaal pad zijn. Standaard ingesteld %systemdrive%\programdata\wssdagent voor alle implementaties.
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
De grootte van de VIRTUELE machine die moet worden gemaakt voor het besturingsvlak. Als u een lijst met beschikbare VM-grootten wilt ophalen, voert u de opdracht uit 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
Pad naar een openbaar SSH-sleutelbestand. Met deze openbare sleutel kunt u zich aanmelden bij een van de VM's die zijn gemaakt door de hybride AKS-implementatie. Als u uw eigen openbare SSH-sleutel hebt, geeft u hier de locatie door. Als er geen sleutel is opgegeven, zoeken we er een onder %systemdrive%\akshci\.ssh\akshci_rsa.pub. Als het bestand niet bestaat, wordt er een SSH-sleutelpaar gegenereerd op deze locatie en gebruikt.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Hiermee geeft u het begin van het MAC-adres van de MAC-pool die u wilt gebruiken voor de Azure Kubernetes Service-host-VM. De syntaxis voor het MAC-adres vereist dat de minst significante bit van de eerste byte altijd 0 is en dat de eerste byte altijd een even getal moet zijn (dat wil gezegd: 00, 02, 04, 06...). Een typisch MAC-adres kan er als volgt uitzien: 02:1E:2B:78:00:00. Gebruik MAC-pools voor langdurige implementaties, zodat MAC-adressen die zijn toegewezen, consistent zijn. MAC-pools zijn handig als u een vereiste hebt dat de VM's specifieke MAC-adressen hebben. De standaardwaarde is None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Hiermee geeft u het einde van het MAC-adres van de MAC-pool die u wilt gebruiken voor de Azure Kubernetes Service-host-VM. De syntaxis voor het MAC-adres vereist dat de minst significante bit van de eerste byte altijd 0 is en dat de eerste byte altijd een even getal moet zijn (dat wil gezegd: 00, 02, 04, 06...). De eerste byte van het adres dat is doorgegeven als het -macPoolEnd moet hetzelfde zijn als de eerste byte van het adres dat is doorgegeven als de -macPoolStart. Gebruik MAC-pools voor langdurige implementaties, zodat MAC-adressen die zijn toegewezen, consistent zijn. MAC-pools zijn handig als u een vereiste hebt dat de VM's specifieke MAC-adressen hebben. De standaardwaarde is None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Het proxyobject dat is gemaakt met 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
Biedt een statisch IP-/netwerkvoorvoegsel dat moet worden toegewezen aan de MOC CloudAgent-service. Deze waarde moet worden opgegeven met behulp van de CIDR-indeling; bijvoorbeeld 192.168.1.2/16. U kunt deze parameter opgeven om ervoor te zorgen dat alles wat belangrijk is op het netwerk altijd toegankelijk is, omdat het IP-adres niet wordt gewijzigd. De standaardwaarde is None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-versie
De versie van AKS Hybrid die u wilt implementeren. De standaardwaarde is de nieuwste versie. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Het TCP/IP-poortnummer waarop knooppuntagenten moeten luisteren, wat standaard 45000 is. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Het TCP/IP-poortnummer dat knooppuntagenten moeten gebruiken voor hun autorisatiepoort. De standaardwaarde is 45001. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Het TCP/IP-poortnummer waarop de cloudagent moet luisteren. De standaardwaarde is 55000. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Het TCP/IP-poortnummer dat de cloudagent moet gebruiken voor de autorisatiepoort. De standaardwaarde is 65000. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Hiermee geeft u de naam op die moet worden gebruikt bij het maken van de cloudagent als een algemene service binnen het cluster. Deze parameter wordt standaard ingesteld op een unieke naam met een voorvoegsel van ca- en een GUID-achtervoegsel. Het wordt afgeraden de standaardwaarde te wijzigen.
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
Biedt een aangepaste microsoft-locatienaam voor de cloud. De standaardnaam is MocLocation. Het wordt afgeraden de standaardwaarde te wijzigen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Aanvragen dat het script controles overslaat om te bevestigen dat geheugen en schijfruimte beschikbaar zijn voordat de implementatie kan worden voortgezet. We raden u niet aan deze instelling te gebruiken.
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
Aanvragen die door het script worden uitgevoerd, worden controles overgeslagen om externe mogelijkheden te bevestigen voor zowel lokale als externe knooppunten. We raden u niet aan deze instelling te gebruiken.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-onzeker
Implementeert hybride AKS-onderdelen, zoals cloudagent en knooppuntagent(s), in onveilige modus (geen met TLS beveiligde verbindingen). Het wordt afgeraden om de onveilige modus te gebruiken in productieomgevingen.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Gebruik deze vlag als u alle beschikbare updates wilt overslaan. We raden u niet aan deze instelling te gebruiken.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
DNS-replicatie kan een uur duren voor sommige systemen. Dit zorgt ervoor dat de implementatie traag is. Als u dit probleem ondervindt, ziet u dat dit Install-AksHci vastzit in een lus. Als u dit probleem wilt achterhalen, probeert u deze vlag te gebruiken. De -forceDnsReplication vlag is geen gegarandeerde oplossing. Als de logica achter de vlag mislukt, wordt de fout verborgen en wordt de opdracht uitgevoerd alsof de vlag niet is opgegeven.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Gebruik deze vlag als u de validatiecontroles van de omgevingsinfrastructuur en gebruikersconfiguratie-invoer wilt overslaan. Deze controles markeren mogelijke problemen die moeten worden opgelost voordat u doorgaat met de installatie. We raden u niet aan deze instelling te gebruiken.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False