Set-AksHciConfig

發行項
11/23/2024

概要

設定或更新 Azure Kubernetes Service 主機的組態設定。

語法

設定主機的組態

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]

描述

設定 Azure Kubernetes Service 主機的組態設定。如果您要在 2-4 節點上部署 Azure 本機叢集或 Windows Server 2019 Datacenter 故障轉移叢集，您必須指定 -workingDir 和 -cloudConfigLocation 參數。對於單一節點 Windows Server 2019 Datacenter，所有參數都是選擇性的，並設定為預設值。不過，為了達到最佳效能，我們建議使用 2-4 節點的 Azure 本機叢集部署。

範例

使用 DHCP 網路在 2-4 節點叢集上部署

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"

使用靜態 IP 網路進行部署

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"

使用 Proxy 伺服器部署

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"

參數

-imageDir

AKS 混合式儲存其 VHD 映像所在的目錄路徑。此為必要參數。路徑必須指向共享記憶體路徑，例如 C:\ClusterStorage\Volume2\ImageStore、或 SMB 共用，例如 \\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

模組用來儲存小型檔案的工作目錄。此為必要參數。路徑必須指向共享記憶體路徑，例如 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

雲端代理程式儲存其設定的位置。此為必要參數。路徑必須指向共享記憶體路徑，例如 C:\ClusterStorage\Volume2\ImageStore、或 SMB 共用，例如 \\FileShare\ImageStore。位置必須位於高可用性共用上，才能一律存取記憶體。

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

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

-vnet

使用 New-AksHciNetworkSetting 命令建立的 AksHciNetworkSetting 物件名稱。

Type: VirtualNetwork
Parameter Sets: (All)
Aliases:

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

-createAutoConfigContainers

可讓您停用叢集共用磁碟區上 VM 數據的自動散發（CSV）。若要停用自動散發，請使用 false 作為此參數的自變數。如果停用自動散發，只會使用您選取的 imageDir CSV。預設值是 true。

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

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

-offlineDownload

在 Install-AksHci 期間叫用離線下載。您也必須執行 Enable-AksHciOfflineDownload。這個旗標會與 -stagingShare 參數搭配使用。

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

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

-offsiteTransferCompleted

設定部署，以在 Install-AksHci 期間使用下載的成品，並傳輸至部署伺服器。這個旗標會與 -offlineDownload 和 -stagingShare 參數搭配使用。

-模式

您要用於離線下載的下載模式。如果您要 AKS 混合式部署的最低映像，請使用 minimum 。此選項包含必要的 Linux 映像，而且只包含必要的 Kubernetes 映像。如果您要 AKS 混合式部署的所有映像，請使用 full 。此選項包含所有 Linux 和 Windows 映像，以及所有支援的 Kubernetes 映射。搭配參數使用 -offlineDownload 此參數。預設值為 full。

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

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

-stagingShare

您要下載映像的本機路徑。與 offlineDownload 參數搭配使用。

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

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

-nodeConfigLocation

節點代理程式儲存其組態的位置。每個節點都有節點代理程式，因此其設定是該節點的本機設定。此位置必須是本機路徑。 %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

要為控制平面建立的 VM 大小。若要取得可用 VM 大小的清單，請執行 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

SSH 公鑰檔案的路徑。使用此公鑰，您可以登入 AKS 混合式部署所建立的任何 VM。如果您有自己的 SSH 公鑰，請在這裡傳遞其位置。如果沒有提供金鑰，我們會在 .pub 下 %systemdrive%\akshci\.ssh\akshci_rsa尋找一個。如果檔案不存在，就會在此位置產生 SSH 金鑰組並使用。

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

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

-macPoolStart

指定您要用於 Azure Kubernetes Service 主機 VM 之 MAC 集區的 MAC 位址開頭。 MAC 位址的語法要求第一個字節中最小有效位應一律為 0，而第一個字節應該一律為偶數（也就是 00、02、04、06...）。典型的 MAC 位址如下所示：02：1E：2B：78：00：00。針對長時間執行的部署使用 MAC 集區，讓指派的 MAC 位址保持一致。如果您有 VM 具有特定 MAC 位址的需求，MAC 集區會很有用。預設值為 None。

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

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

-macPoolEnd

指定您要用於 Azure Kubernetes Service 主機 VM 之 MAC 集區的 MAC 位址結尾。 MAC 位址的語法要求第一個字節中最小有效位應一律為 0，而第一個字節應該一律為偶數（也就是 00、02、04、06...）。傳遞為 -macPoolEnd 之位址的第一個字節應該與傳遞為 -macPoolStart之位址的第一個字節相同。針對長時間執行的部署使用 MAC 集區，讓指派的 MAC 位址保持一致。如果您有 VM 具有特定 MAC 位址的需求，MAC 集區會很有用。預設值為 None。

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

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

-proxySettings

使用 New-AksHciProxySetting 建立的 Proxy 物件。

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

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

-cloudServiceCidr

提供要指派給MOC CloudAgent服務的靜態IP/網路前置詞。此值應使用 CIDR 格式提供;例如， 192.168.1.2/16。您可能想要指定此參數，以確保網路上的任何重要專案一律可供存取，因為 IP 位址不會變更。預設值為 None。

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

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

-version

您想要部署的 AKS 混合式版本。預設值為最新版本。我們不建議變更預設值。

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 埠號碼，預設為 45000。 我們不建議變更預設值。

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 埠號碼。預設值為 45001。我們不建議變更預設值。

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 埠號碼。預設值為55000。我們不建議變更預設值。

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 埠號碼。預設值為 65000。我們不建議變更預設值。

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

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

-clusterRoleName

指定要在叢集中建立雲端代理程式做為一般服務時使用的名稱。此參數預設為唯一名稱，其前置 詞為 ca- 和 GUID 後綴。我們不建議變更預設值。

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

提供自定義Microsoft操作的雲端位置名稱。預設名稱為 MocLocation。我們不建議變更預設值。

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

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

-skipHostLimitChecks

要求腳本略過任何檢查，以確認記憶體和磁碟空間可供使用，再允許部署繼續進行。不建議使用此設定。

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

要求腳本略過任何檢查，以確認本機和遠端節點的遠端功能。不建議使用此設定。

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

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

-不安全的

以不安全模式部署 AKS 混合式元件，例如雲端代理程式和節點代理程式（s），沒有 TLS 安全連線。 不建議在生產環境中使用不安全模式。

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

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

-skipUpdates

如果您想要略過任何可用的更新，請使用此旗標。不建議使用此設定。

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

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

-forceDnsReplication

某些系統上的 DNS 複寫最多可能需要一小時的時間。這會導致部署速度變慢。如果您遇到此問題，您會看到該 Install-AksHci 問題卡在迴圈中。若要超過此問題，請嘗試使用此旗標。旗 -forceDnsReplication 標不是保證的修正。如果旗標背後的邏輯失敗，則會隱藏錯誤，而且命令會繼續，就像未提供旗標一樣。

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

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

-skipValidationChecks

如果您想要略過環境基礎結構和使用者設定輸入的驗證檢查，請使用此旗標。這些檢查會醒目提示潛在問題，再繼續進行安裝。不建議使用此設定。

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

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

下一步

AksHci PowerShell 參考

共用方式為