Task 09: Disable Unused Network Adapters
The automated OS configuration run covers this task in the UnusedAdapters step (ports the file marks unused are disabled). Use the manual steps below when you can't use the run, or to understand or troubleshoot what it does. See how the run works.
DOCUMENT CATEGORY: Runbook SCOPE: Disable network adapters not used for management to prevent configuration iss... PURPOSE: Disable network adapters not used for management to prevent configuration issues during cluster deployment MASTER REFERENCE: Azure Local Network Adapter Requirements
Status: Active
Overview
Disable network adapters that are not connected. Only the management adapter needs to remain enabled at this stage. Compute and storage adapters are configured later in Phase 16.
The commands on the Direct tab only disable adapters whose status is Disconnected. The iDRAC USB NIC (Remote NDIS Compatible Device) is connected, so it stays enabled, which is what Dell requires for SBE health checks (Dell SBE release notes). Don't disable it by hand.
On the simplified provisioning route this task is optional. When every port is cabled, nothing is disconnected. See the decision matrix.
Verify which adapter is your active management connection before running. Disabling the wrong adapter requires console access to recover.
Prerequisites
| Requirement | Details |
|---|---|
| Tasks 01–08 complete | OS configured, ICMP enabled |
| Management adapter identified | Know which NIC is your active connection |
Values from infrastructure.yml
The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.
Execution Options
- Direct (On Node)
- Orchestrated Script
Run on each node individually via console, KVM, or RDP.
Run the commands below by hand. The earlier toolkit script Disable-UnusedAdapters.ps1 is removed; the OS configuration does this task in its UnusedAdapters step (ports the file marks unused are disabled).
# Task 09 - Disable Unused Network Adapters
# No variables required - targets all adapters with Status = Disconnected
Get-NetAdapter | Format-Table Name, Status, LinkSpeed -AutoSize
Get-NetAdapter | Where-Object { $_.Status -eq "Disconnected" } | Disable-NetAdapter -Confirm:$false
Get-NetAdapter | Format-Table Name, Status, LinkSpeed -AutoSize
PowerShell
No script in this task folder. The folder
scripts/deploy/04-cluster-deployment/phase-03-os-configuration/task-09-disable-unused-network-adaptersholds only a placeholder. A placeholder printsNOT IMPLEMENTED, changes nothing and exits with code 3. The earlierDisable-UnusedAdapters.ps1is removed. The OS configuration does this task in its UnusedAdapters step.
Script
| Script | What it does |
|---|---|
scripts/deploy/04-cluster-deployment/phase-03-os-configuration/Invoke-AzureLocalOsConfiguration.ps1 | The one entry point of the OS configuration. It runs Set-AzureLocalNodeConfiguration.ps1 for each node: it reads the node, changes only what differs from infrastructure.yml, and reports. -Step limits the run to one step. |
The nodes' local administrator comes from identity.local_admin of infrastructure.yml (the password is a secret reference), or from -Credential. The script never prompts. Run settings go in a JSON file given with -SettingsFile.
Run
# Plan (the default): read every node and list what would change
./Invoke-AzureLocalOsConfiguration.ps1 -InfrastructureFile ./infrastructure.yml -Step UnusedAdapters
# Apply
./Invoke-AzureLocalOsConfiguration.ps1 -InfrastructureFile ./infrastructure.yml -Step UnusedAdapters -Mode Apply
See how the run works.
Validation
# Confirm no Disconnected adapters remain enabled
Get-NetAdapter | Format-Table Name, Status, LinkSpeed -AutoSize
Expected: Only the management adapter shows Up. All others show Disabled.
Validation Checklist
- Management adapter remains
Upon all nodes - All unused adapters show
Disabled - Nodes still accessible over management network
Troubleshooting
| Issue | Resolution |
|---|---|
| Lost connectivity after running | Re-enable the adapter from console: Enable-NetAdapter -Name "<name>" |
| Adapter won't disable | Check for active sessions on that adapter |
Alternatives
The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.
Navigation
← Task 08: Enable ICMP · ↑ Phase 03 · Task 10: Configure Hostname →
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0.0 | 2025-03-25 | Azure Local Cloud | Initial release |