Azure-beli virtuálisgép-bővítmények engedélyezése az Azure CLI használatával
Ez a cikk az Azure Arc-kompatibilis kiszolgálók által támogatott virtuálisgép-bővítmények üzembe helyezését, frissítését, frissítését és eltávolítását ismerteti. Bemutatja, hogyan hajthatja végre ezeket a feladatokat Linux vagy Windows rendszerű hibrid gépeken az Azure CLI használatával.
Feljegyzés
Az Azure Arc-kompatibilis kiszolgálók nem támogatják a virtuálisgép-bővítmények üzembe helyezését és kezelését az Azure-beli virtuális gépeken. Azure-beli virtuális gépek esetén tekintse meg a virtuálisgép-bővítmény áttekintési cikkét .
Előfeltételek
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
Az Azure CLI-bővítmény telepítése
A ConnectedMachine-parancsok nem az Azure CLI részeként lesznek szállítva. Mielőtt az Azure CLI használatával csatlakozik az Azure-hoz, és felügyelné a virtuálisgép-bővítményeket az Azure Arc-kompatibilis kiszolgálók által felügyelt hibrid kiszolgálón, be kell töltenie a ConnectedMachine bővítményt.
Ezeket a felügyeleti műveleteket a munkaállomáson hajthatja végre. Nem kell futtatnia őket az Azure Arc-kompatibilis kiszolgálón.
Futtassa a következő parancsot az Azure CLI ConnectedMachine bővítmény telepítéséhez:
az extension add --name connectedmachine
Bővítmény engedélyezése
Ha engedélyezni szeretne egy virtuálisgép-bővítményt az Azure Arc-kompatibilis kiszolgálón, használja az connectedmachine extension create
a --machine-name
, --extension-name
, --location
, --type
, settings
és --publisher
paramétereket.
Az alábbi példa engedélyezi az egyéni szkriptbővítményt egy Azure Arc-kompatibilis kiszolgálón:
az connectedmachine extension create --machine-name "myMachineName" --name "CustomScriptExtension" --location "regionName" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"
Az alábbi példa engedélyezi az Azure Key Vault virtuálisgép-bővítményt egy Azure Arc-kompatibilis kiszolgálón:
az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'
Az alábbi példa engedélyezi a Microsoft Antimalware bővítményt egy Azure Arc-kompatibilis Windows-kiszolgálón:
az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'
Az alábbi példa engedélyezi a Datadog bővítményt egy Azure Arc-kompatibilis Windows-kiszolgálón:
az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'
Telepített bővítmények listázása
Az Azure Arc-kompatibilis kiszolgálón található virtuálisgép-bővítmények listájának lekéréséhez használja az connectedmachine extension list
a paramétereket és --resource-group
a --machine-name
paramétereket.
Példa:
az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"
Alapértelmezés szerint az Azure CLI-parancsok kimenete JSON-ban (JavaScript Object Notation) van. Ha az alapértelmezett kimenetet listára vagy táblára szeretné módosítani, használja például az az config set core.output=table parancsot. Bármely parancshoz hozzáadhatja --output
a kimeneti formátum egyszeri módosítását.
Az alábbi példa a parancs részleges JSON-kimenetét az connectedmachine extension -list
mutatja be:
[
{
"autoUpgradingMinorVersion": "false",
"forceUpdateTag": null,
"id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
"location": "regionName",
"name": "DependencyAgentWindows",
"namePropertiesInstanceViewName": "DependencyAgentWindows",
Bővítménykonfiguráció frissítése
Egyes virtuálisgép-bővítmények konfigurációs beállításokat igényelnek, hogy telepíthesse őket egy Azure Arc-kompatibilis kiszolgálón (például az egyéni szkriptbővítményen). A bővítmény konfigurációjának frissítéséhez használja az connectedmachine extension update
a következőt: .
Az alábbi példa bemutatja, hogyan konfigurálhatja az egyéni szkriptbővítményt:
az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"
Bővítmények frissítése
A támogatott virtuálisgép-bővítmények új verziójának kiadásakor frissítheti azt a legújabb kiadásra. A virtuálisgép-bővítmény frissítéséhez használja az connectedmachine upgrade-extension
az --machine-name
, --resource-group
és --extension-targets
a paramétereket.
--extension-targets
A paraméterhez meg kell adnia a bővítményt és a legújabb elérhető verziót. A bővítményhez elérhető legújabb verzió meghatározásához nyissa meg a kijelölt Azure Arc-kompatibilis kiszolgáló Bővítmények lapját az Azure Portalon, vagy futtassa az az virtuálisgép-bővítmény képlistáját. Egyetlen frissítési kérelemben több bővítményt is megadhat, ha mindkettőt megadja:
- A bővítmények vesszővel tagolt listája, amelyet a közzétevő és a típus határoz meg (ponttal elválasztva)
- Az egyes bővítmények célverziója
A telepített virtuálisgép-bővítmények verzióját bármikor áttekintheti a parancs az connectedmachine extension list
futtatásával. A typeHandlerVersion
tulajdonság értéke a bővítmény verzióját jelöli.
Bővítmények eltávolítása
Ha el szeretne távolítani egy telepített virtuálisgép-bővítményt az Azure Arc-kompatibilis kiszolgálóról, használja az connectedmachine extension delete
a --extension-name
, --machine-name
és --resource-group
paramétereket.
Kapcsolódó tartalom
- A virtuálisgép-bővítmények üzembe helyezése, kezelése és eltávolítása az Azure PowerShell, az Azure Portal vagy az Azure Resource Manager-sablonok használatával történik.
- A virtuálisgép-bővítmények hibaelhárításáról az útmutatóban talál hibaelhárítási információkat.
- A parancsokkal kapcsolatos további információkért tekintse át az Azure CLI virtuálisgép-bővítmény áttekintését.