Set-AksHciConfig
Riepilogo
Imposta o aggiorna le impostazioni di configurazione per l'host servizio Azure Kubernetes.
Sintassi
Impostare la configurazione per l'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]
Descrizione
Imposta le impostazioni di configurazione per l'host servizio Azure Kubernetes. Se si esegue la distribuzione in un cluster Azure Stack HCI a 2-4 nodi o in un cluster di failover di Windows Server 2019 Datacenter, è necessario specificare i -workingDir parametri e -cloudConfigLocation . Per windows Server 2019 Datacenter a nodo singolo, tutti i parametri sono facoltativi e impostati su valori predefiniti. Tuttavia, per ottenere prestazioni ottimali, è consigliabile usare una distribuzione di cluster Azure Stack HCI a 2-4 nodi.
Esempio
Per eseguire la distribuzione in un cluster a 2-4 nodi con rete 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"
Per eseguire la distribuzione con rete IP statica
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"
Per eseguire la distribuzione con un server 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"
Parametri
-imageDir
Percorso della directory in cui il servizio Azure Kubernetes ibrido archivia le immagini del disco rigido virtuale. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio C:\ClusterStorage\Volume2\ImageStore, o a una condivisione SMB, ad esempio \\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
Directory di lavoro per il modulo da usare per l'archiviazione di file di piccole dimensioni. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio 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
Posizione in cui l'agente cloud archivia la configurazione. Questo parametro è obbligatorio. Il percorso deve puntare a un percorso di archiviazione condiviso, ad esempio C:\ClusterStorage\Volume2\ImageStore, o a una condivisione SMB, \\FileShare\ImageStoread esempio . La posizione deve trovarsi in una condivisione a disponibilità elevata in modo che l'archiviazione sia sempre accessibile.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: %systemdrive%\wssdcloudagent
Accept pipeline input: False
Accept wildcard characters: False
-vnet
Nome dell'oggetto AksHciNetworkSetting creato con il New-AksHciNetworkSetting comando .
Type: VirtualNetwork
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createAutoConfigContainers
Consente di disabilitare la distribuzione automatica dei dati delle macchine virtuali nei volumi condivisi del cluster . Per disabilitare la distribuzione automatica, usare false come argomento per questo parametro. Se la distribuzione automatica è disabilitata, viene usato solo il file CSV selezionato per imageDir . Il valore predefinito è true.
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-offlineDownload
Richiama il download offline durante Install-AksHci. È anche necessario eseguire Enable-AksHciOfflineDownload. Questo flag viene usato in combinazione con il -stagingShare parametro .
Type: System.Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-offsiteTransferCompleted
Imposta la distribuzione in modo da usare gli artefatti scaricati fuori sede e trasferiti al server di distribuzione durante Install-AksHci. Questo flag viene usato in combinazione con il -offlineDownload parametro e -stagingShare .
-Modalità
Modalità di download da usare per il download offline. Usare minimum se si vogliono ottenere le immagini minime per la distribuzione ibrida del servizio Azure Kubernetes. Questa opzione include le immagini Linux necessarie e solo l'immagine Kubernetes necessaria. Usare full se si vogliono tutte le immagini per la distribuzione ibrida del servizio Azure Kubernetes. Questa opzione include tutte le immagini Linux e Windows e tutte le immagini Kubernetes supportate. Usare questo parametro in combinazione con il -offlineDownload parametro . Il valore predefinito è full.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: full
Accept pipeline input: False
Accept wildcard characters: False
-stagingShare
Percorso locale in cui si desidera scaricare le immagini. Usare in tandem con il offlineDownload parametro .
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
-nodeConfigLocation
Posizione in cui gli agenti del nodo archiviano la configurazione. Ogni nodo ha un agente del nodo, quindi la configurazione è locale per tale nodo. Questo percorso deve essere un percorso locale. Il valore predefinito è %systemdrive%\programdata\wssdagent per tutte le distribuzioni.
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
Dimensioni della macchina virtuale da creare per il piano di controllo. Per ottenere un elenco delle dimensioni delle macchine virtuali disponibili, eseguire 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
Percorso di un file di chiave pubblica SSH. Usando questa chiave pubblica, è possibile accedere a una delle macchine virtuali create dalla distribuzione ibrida del servizio Azure Kubernetes. Se si ha la propria chiave pubblica SSH, passare la relativa posizione qui. Se non viene fornita alcuna chiave, ne viene cercata una in %systemdrive%\akshci\.ssh\akshci_rsa.pub. Se il file non esiste, viene generata una coppia di chiavi SSH in questo percorso e viene usata.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolStart
Specifica l'inizio dell'indirizzo MAC del pool MAC che si vuole usare per la macchina virtuale host servizio Azure Kubernetes. La sintassi per l'indirizzo MAC richiede che il bit meno significativo del primo byte sia sempre 0 e il primo byte deve sempre essere un numero pari (ovvero 00, 02, 04, 06...). Un indirizzo MAC tipico può essere simile al seguente: 02:1E:2B:78:00:00. Usare i pool MAC per le distribuzioni di lunga durata in modo che gli indirizzi MAC assegnati siano coerenti. I pool MAC sono utili se si ha un requisito per cui le macchine virtuali hanno indirizzi MAC specifici. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-macPoolEnd
Specifica la fine dell'indirizzo MAC del pool MAC che si vuole usare per la macchina virtuale host servizio Azure Kubernetes. La sintassi per l'indirizzo MAC richiede che il bit meno significativo del primo byte sia sempre 0 e il primo byte deve sempre essere un numero pari (ovvero 00, 02, 04, 06...). Il primo byte dell'indirizzo passato come -macPoolEnd deve essere uguale al primo byte dell'indirizzo passato come -macPoolStart. Usare i pool MAC per le distribuzioni di lunga durata in modo che gli indirizzi MAC assegnati siano coerenti. I pool MAC sono utili se si ha un requisito per cui le macchine virtuali hanno indirizzi MAC specifici. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-proxySettings
Oggetto proxy creato con 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
Fornisce un prefisso ip/rete statico da assegnare al servizio MOC CloudAgent. Questo valore deve essere fornito usando il formato CIDR; ad esempio 192.168.1.2/16. È possibile specificare questo parametro per assicurarsi che qualsiasi elemento importante nella rete sia sempre accessibile, perché l'indirizzo IP non cambia. Il valore predefinito è None.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-version
Versione ibrida del servizio Azure Kubernetes che si vuole distribuire. Il valore predefinito è la versione più recente. Non è consigliabile modificare il valore predefinito.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Latest version
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentPort
Numero di porta TCP/IP in cui gli agenti del nodo devono essere in ascolto, che per impostazione predefinita è 45000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45000
Accept pipeline input: False
Accept wildcard characters: False
-nodeAgentAuthorizerPort
Numero di porta TCP/IP che gli agenti del nodo devono usare per la porta di autorizzazione. Il valore predefinito è 45001. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 45001
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentPort
Numero di porta TCP/IP su cui l'agente cloud deve essere in ascolto. Il valore predefinito è 55000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 55000
Accept pipeline input: False
Accept wildcard characters: False
-cloudAgentAuthorizerPort
Numero di porta TCP/IP che l'agente cloud deve usare per la porta di autorizzazione. Il valore predefinito è 65000. Non è consigliabile modificare il valore predefinito.
Type: System.Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 65000
Accept pipeline input: False
Accept wildcard characters: False
-clusterRoleName
Specifica il nome da usare quando si crea l'agente cloud come servizio generico all'interno del cluster. Questo parametro viene predefinito in un nome univoco con un prefisso di ca e un suffisso GUID. Non è consigliabile modificare il valore predefinito.
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
Fornisce un nome personalizzato di posizione cloud gestito da Microsoft. Il nome predefinito è MocLocation. Non è consigliabile modificare il valore predefinito.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: MocLocation
Accept pipeline input: False
Accept wildcard characters: False
-skipHostLimitChecks
Richiede che lo script ignora i controlli per verificare che lo spazio su memoria e disco sia disponibile prima di consentire alla distribuzione di procedere. Non è consigliabile usare questa impostazione.
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
Richiede che lo script ignora eventuali controlli per confermare le funzionalità di comunicazione remota a nodi locali e remoti. Non è consigliabile usare questa impostazione.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Insicuro
Distribuisce i componenti ibridi del servizio Azure Kubernetes, ad esempio agente cloud e agenti del nodo, in modalità non sicura (nessuna connessione protetta TLS). Non è consigliabile usare la modalità non sicura negli ambienti di produzione.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipUpdates
Usare questo flag se si desidera ignorare eventuali aggiornamenti disponibili. Non è consigliabile usare questa impostazione.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-forceDnsReplication
La replica DNS può richiedere fino a un'ora in alcuni sistemi. Ciò causa la lentezza della distribuzione. Se si verifica questo problema, si noterà che Install-AksHci è bloccato in un ciclo. Per superare questo problema, provare a usare questo flag. Il -forceDnsReplication flag non è una correzione garantita. Se la logica dietro il flag ha esito negativo, l'errore è nascosto e il comando procede come se il flag non è stato specificato.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skipValidationChecks
Usare questo flag se si desidera ignorare i controlli di convalida dell'infrastruttura di ambiente e l'input di configurazione utente. Questi controlli evidenziano potenziali problemi da risolvere prima di procedere con l'installazione. Non è consigliabile usare questa impostazione.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Passaggi successivi
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per