Set-AksHciConfig

發行項
05/11/2023

概要

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

Syntax

設定主機的組態

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

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

範例

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

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

-insecure

以不安全模式部署 AKS 混合式元件，例如雲端代理程式和節點代理程式 () ， (沒有 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 參考