WSL ਸੈੱਟਅੱਪ

WSL Dashboard ਦੀ ਵਰਤੋਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ, ਤੁਹਾਡੇ Windows ਸਿਸਟਮ ਵਿੱਚ WSL 2 ਵਾਤਾਵਰਨ ਨੂੰ ਸਹੀ ਢੰਗ ਨਾਲ ਸਮਰੱਥ ਅਤੇ ਕੌਂਫਿਗਰ ਕੀਤਾ ਜਾਣਾ ਲਾਜ਼ਮੀ ਹੈ। ਇਹ ਦਸਤਾਵੇਜ਼ ਹੇਠ ਲਿਖੇ ਤਿੰਨ ਮੁੱਖ ਭਾਗਾਂ ਵਿੱਚ ਵੰਡਿਆ ਗਿਆ ਹੈ:

1. WSL ਸਮਰੱਥ ਕਰਨਾ ਅਤੇ ਕੌਂਫਿਗਰ ਕਰਨਾ: WSL 2 ਦੀ ਬੁਨਿਆਦੀ ਸਥਾਪਨਾ ਅਤੇ ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੂਰੀ ਕਰੋ।
2. ਕਮਾਂਡ ਉਪਲਬਧ ਹੋਣਾ ਸਥਾਪਨਾ ਦੀ ਸਫਲਤਾ ਦੇ ਬਰਾਬਰ ਨਹੀਂ ਹੈ: ਦੱਸਦਾ ਹੈ ਕਿ wsl ਕਮਾਂਡ ਦਾ ਚੱਲਣਾ ਇਹ ਨਹੀਂ ਦਰਸਾਉਂਦਾ ਕਿ Linux ਸਫਲਤਾਪੂਰਵਕ ਸਥਾਪਿਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।
3. ਸਥਾਪਨਾ ਅਸਫਲਤਾ ਦਾ ਹੱਲ: ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੂਰੀ ਹੋਣ ਤੋਂ ਬਾਅਦ ਵੀ ਸਥਾਪਨਾ ਅਸਫਲ ਹੋਣ 'ਤੇ ਜਾਂਚ ਅਤੇ ਮੁਰੰਮਤ ਦੇ ਤਰੀਕੇ।

1. WSL ਸਮਰੱਥ ਕਰਨਾ ਅਤੇ ਕੌਂਫਿਗਰ ਕਰਨਾ

ਇਹ ਅਧਿਆਇ ਤੁਹਾਨੂੰ ਲੋੜੀਂਦੀਆਂ ਬੁਨਿਆਦੀ ਸੈਟਿੰਗਾਂ ਪੂਰੀਆਂ ਕਰਨ ਵਿੱਚ ਮਾਰਗਦਰਸ਼ਨ ਕਰੇਗਾ। ਇਹ ਅਧਿਆਇ ਪੂਰਾ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਕਮਾਂਡ ਉਪਲਬਧ ਹੋਣ ਅਤੇ ਸਥਾਪਨਾ ਸਫਲ ਹੋਣ ਵਿਚਕਾਰ ਫਰਕ ਸਮਝਣ ਲਈ ਅਧਿਆਇ 2 ਪੜ੍ਹੋ; ਜੇਕਰ ਸਥਾਪਨਾ ਵਿੱਚ ਅਜੇ ਵੀ ਸਮੱਸਿਆ ਆਉਂਦੀ ਹੈ, ਤਾਂ ਅਧਿਆਇ 3 ਦੇਖੋ।

1.1 ਸਿਸਟਮ ਲੋੜਾਂ ਜਾਂਚੋ

WSL 2 ਲਈ Windows ਵਰਜ਼ਨ ਦੀਆਂ ਘੱਟੋ-ਘੱਟ ਲੋੜਾਂ ਹਨ। ਆਪਣਾ ਵਰਜ਼ਨ ਜਾਂਚਣ ਲਈ Win + R ਦਬਾਓ, winver ਟਾਈਪ ਕਰੋ:

• Windows 10: ਵਰਜ਼ਨ 1903 ਜਾਂ ਇਸ ਤੋਂ ਵੱਧ, ਅਤੇ ਬਿਲਡ (Build) 18362 ਜਾਂ ਇਸ ਤੋਂ ਵੱਧ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।
• Windows 11: ਸਾਰੇ ਵਰਜ਼ਨ ਸਮਰਥਿਤ ਹਨ।

IMPORTANT

ਜੇਕਰ ਤੁਹਾਡਾ ਵਰਜ਼ਨ ਬਹੁਤ ਪੁਰਾਣਾ ਹੈ, ਤਾਂ ਪਹਿਲਾਂ "Windows Update" ਰਾਹੀਂ ਆਪਣੇ ਸਿਸਟਮ ਨੂੰ ਅੱਪਗਰੇਡ ਕਰੋ।

1.2 ਹਾਰਡਵੇਅਰ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਸਮਰੱਥ ਕਰੋ

WSL 2 ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਤਕਨੀਕ 'ਤੇ ਚਲਦਾ ਹੈ, ਇਸ ਲਈ ਮਦਰਬੋਰਡ ਦੇ BIOS/UEFI ਵਿੱਚ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਤਕਨੀਕ (Virtualization Technology) ਸਮਰੱਥ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ।

• ਜਾਂਚ ਦਾ ਤਰੀਕਾ: "ਟਾਸਕ ਮੈਨੇਜਰ" ਖੋਲ੍ਹੋ -> "ਕਾਰਗੁਜ਼ਾਰੀ" ਟੈਬ -> "CPU"।
• ਸਥਿਤੀ ਦੇਖੋ: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਹੇਠਾਂ ਸੱਜੇ ਪਾਸੇ "ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ" ਦੀ ਸਥਿਤੀ "ਸਮਰੱਥ" ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ।
• ਸਮਰੱਥ ਕਰਨ ਦਾ ਤਰੀਕਾ: ਜੇਕਰ ਸਮਰੱਥ ਨਹੀਂ ਹੈ, ਤਾਂ ਤੁਹਾਨੂੰ ਕੰਪਿਊਟਰ ਮੁੜ ਚਾਲੂ ਕਰਕੇ BIOS/UEFI ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਜਾਣਾ ਹੋਵੇਗਾ, Intel VT-x ਜਾਂ AMD-V ਵਰਗਾ ਵਿਕਲਪ ਲੱਭ ਕੇ ਉਸਨੂੰ Enabled 'ਤੇ ਸੈੱਟ ਕਰਨਾ ਹੋਵੇਗਾ।

1.3 Windows ਸੰਬੰਧੀ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਸਮਰੱਥ ਕਰੋ

ਤੁਹਾਨੂੰ Windows ਦੀਆਂ "Windows Subsystem for Linux" ਅਤੇ "Virtual Machine Platform" ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਨੂੰ ਸਮਰੱਥ ਕਰਨਾ ਹੋਵੇਗਾ।

ਵਿਧੀ A: ਗ੍ਰਾਫਿਕਲ ਇੰਟਰਫੇਸ ਰਾਹੀਂ (ਸਿਫਾਰਸ਼ੀ)

1. Win + S ਦਬਾਓ, "Windows ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਚਾਲੂ ਜਾਂ ਬੰਦ ਕਰੋ" ਲੱਭ ਕੇ ਖੋਲ੍ਹੋ।
2. ਹੇਠ ਲਿਖੇ ਦੋ ਵਿਕਲਪਾਂ 'ਤੇ ਨਿਸ਼ਾਨ ਲਗਾਓ:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. "ਠੀਕ ਹੈ" 'ਤੇ ਕਲਿੱਕ ਕਰੋ, ਅਤੇ ਸੰਕੇਤ ਮਿਲਣ 'ਤੇ ਕੰਪਿਊਟਰ ਮੁੜ ਚਾਲੂ ਕਰੋ।

ਵਿਧੀ B: ਕਮਾਂਡ ਲਾਈਨ ਰਾਹੀਂ (ਪ੍ਰਬੰਧਕ ਅਨੁਮਤੀਆਂ)

PowerShell ਨੂੰ ਪ੍ਰਬੰਧਕ ਵਜੋਂ ਚਲਾਓ ਅਤੇ ਹੇਠ ਲਿਖੀਆਂ ਕਮਾਂਡਾਂ ਚਲਾਓ:

# WSL ਸਮਰੱਥ ਕਰੋ
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ ਸਮਰੱਥ ਕਰੋ
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

ਚਲਾਉਣ ਤੋਂ ਬਾਅਦ, ਕਿਰਪਾ ਕਰਕੇ ਮੈਨੂਅਲੀ ਕੰਪਿਊਟਰ ਮੁੜ ਚਾਲੂ ਕਰੋ।

1.4 WSL ਕਰਨਲ ਇੰਸਟਾਲ ਜਾਂ ਅੱਪਡੇਟ ਕਰੋ

ਆਧੁਨਿਕ Windows ਵਰਜ਼ਨ Microsoft Store ਰਾਹੀਂ WSL ਅੱਪਡੇਟ ਪ੍ਰਾਪਤ ਕਰ ਸਕਦੇ ਹਨ।

• ਡਾਊਨਲੋਡ ਪਤਾ: Microsoft Store - Windows Subsystem for Linux
• ਮੈਨੂਅਲ ਡਾਊਨਲੋਡ: ਜੇਕਰ ਸਟੋਰ ਦੀ ਵਰਤੋਂ ਨਹੀਂ ਕਰ ਸਕਦੇ, ਤਾਂ WSL GitHub Releases ਤੋਂ ਨਵੀਨਤਮ .msixbundle ਜਾਂ .msi ਸਥਾਪਨਾ ਪੈਕੇਜ ਡਾਊਨਲੋਡ ਕਰਕੇ ਔਫਲਾਈਨ ਸਥਾਪਿਤ ਕਰ ਸਕਦੇ ਹੋ।

1.5 WSL 2 ਨੂੰ ਡਿਫੌਲਟ ਵਰਜ਼ਨ ਵਜੋਂ ਸੈੱਟ ਕਰੋ

ਇਹ ਯਕੀਨੀ ਬਣਾਉਣ ਲਈ ਕਿ ਨਵੇਂ ਸਥਾਪਿਤ ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਡਿਫੌਲਟ ਤੌਰ 'ਤੇ WSL 2 ਦੀ ਵਰਤੋਂ ਕਰਨ, ਟਰਮੀਨਲ ਵਿੱਚ ਚਲਾਓ:

wsl --set-default-version 2

1.6 ਆਮ ਸਮੱਸਿਆਵਾਂ

• ਗਲਤੀ 0x80370102: ਆਮ ਤੌਰ 'ਤੇ BIOS ਵਿੱਚ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਸਮਰੱਥ ਨਾ ਹੋਣ, ਜਾਂ Hyper-V ਨਾਲ ਟਕਰਾਅ ਹੋਣ ਕਾਰਨ ਹੁੰਦੀ ਹੈ।
• WSL 1 ਅਤੇ WSL 2 ਵਿਚਕਾਰ ਬਦਲਣਾ: ਤੁਸੀਂ wsl --set-version <ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਦਾ ਨਾਮ> 2 ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਮੌਜੂਦਾ WSL 1 ਇੰਸਟੈਂਸ ਨੂੰ WSL 2 ਵਿੱਚ ਅੱਪਗਰੇਡ ਕਰ ਸਕਦੇ ਹੋ।

2. ਕਮਾਂਡ ਉਪਲਬਧ ਹੋਣਾ ਸਥਾਪਨਾ ਦੀ ਸਫਲਤਾ ਦੇ ਬਰਾਬਰ ਨਹੀਂ ਹੈ

wsl --version, wsl -l -v ਵਰਗੀਆਂ ਕਮਾਂਡਾਂ ਦਾ ਸਹੀ ਢੰਗ ਨਾਲ ਚੱਲਣਾ, ਇਹ ਬਿਲਕੁਲ ਨਹੀਂ ਦਰਸਾਉਂਦਾ ਕਿ Linux ਸਥਾਪਿਤ ਕਰਨ ਦੀਆਂ ਸ਼ਰਤਾਂ ਪੂਰੀਆਂ ਹੋ ਗਈਆਂ ਹਨ। ਇਹ ਦੋਵੇਂ ਵੱਖ-ਵੱਖ ਪੜਾਅ ਹਨ, ਇਨ੍ਹਾਂ ਨੂੰ ਬਰਾਬਰ ਨਹੀਂ ਮੰਨਿਆ ਜਾ ਸਕਦਾ।

ਕਮਾਂਡ ਉਪਲਬਧ ਹੋਣਾ ਸਿਰਫ ਇਹ ਦਰਸਾਉਂਦਾ ਹੈ:

• ✅ Windows ਵਿੱਚ WSL ਕੰਪੋਨੈਂਟ ਸਮਰੱਥ/ਸਥਾਪਿਤ ਹੋ ਚੁੱਕੇ ਹਨ
• ✅ wsl.exe ਕਮਾਂਡ-ਲਾਈਨ ਟੂਲ ਉਪਲਬਧ ਹੈ
• ✅ ਸਿਸਟਮ WSL ਨਾਲ ਸੰਬੰਧਿਤ ਕਮਾਂਡਾਂ ਨੂੰ ਪਛਾਣ ਸਕਦਾ ਹੈ

ਪਰ Linux ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਨੂੰ ਸਫਲਤਾਪੂਰਵਕ ਸਥਾਪਿਤ ਕਰਨ ਲਈ ਵਾਧੂ ਸ਼ਰਤਾਂ ਪੂਰੀਆਂ ਕਰਨੀਆਂ ਪੈਂਦੀਆਂ ਹਨ। ਆਮ ਤੌਰ 'ਤੇ ਜਿੱਥੇ ਫਸ ਜਾਂਦਾ ਹੈ:

1. ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਬੰਦ ਹੈ: BIOS/UEFI ਵਿੱਚ VT-x / AMD-V ਸਮਰੱਥ ਨਹੀਂ ਹੈ, WSL 2 ਸ਼ੁਰੂ ਨਹੀਂ ਹੋ ਸਕਦਾ, ਜਾਂ ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਸਥਾਪਿਤ ਕਰਦੇ ਸਮੇਂ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਗਲਤੀ ਦਿਖਾਉਂਦਾ ਹੈ (ਜਾਂਚ ਦਾ ਤਰੀਕਾ ਦੇਖੋ 1.2 ਹਾਰਡਵੇਅਰ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਸਮਰੱਥ ਕਰੋ)।
2. Windows ਵਰਜ਼ਨ/ਬਿਲਡ ਬਹੁਤ ਪੁਰਾਣਾ ਹੈ: WSL 2 ਲਈ ਕਰਨਲ ਅਤੇ ਵਰਜ਼ਨ ਦੀਆਂ ਲੋੜਾਂ ਹਨ; ਹੋਮ ਐਡੀਸ਼ਨ, ਬਹੁਤ ਪੁਰਾਣੀਆਂ ਐਂਟਰਪ੍ਰਾਈਜ਼ ਇਮੇਜਾਂ ਵਿੱਚ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਅਧੂਰੀਆਂ ਹੋ ਸਕਦੀਆਂ ਹਨ (ਜਾਂਚ ਦਾ ਤਰੀਕਾ ਦੇਖੋ 1.1 ਸਿਸਟਮ ਲੋੜਾਂ ਜਾਂਚੋ)।
3. ਅਸਲ ਵਿੱਚ ਕੋਈ Linux ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਸਥਾਪਿਤ ਨਹੀਂ ਕੀਤਾ ਗਿਆ: wsl -l -v ਸਿਰਫ ਸਥਾਪਿਤ ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨਾਂ ਦੀ ਸੂਚੀ ਦਿਖਾਉਂਦਾ ਹੈ; ਜਦੋਂ ਕੁਝ ਵੀ ਸਥਾਪਿਤ ਨਹੀਂ ਹੁੰਦਾ ਤਾਂ ਸੂਚੀ ਖਾਲੀ ਹੁੰਦੀ ਹੈ, ਇਸਦਾ ਮਤਲਬ ਇਹ ਨਹੀਂ ਕਿ Ubuntu ਸਿੱਧਾ ਚਲਾਇਆ ਜਾ ਸਕਦਾ ਹੈ।
4. ਨੈੱਟਵਰਕ / Microsoft Store ਸਮੱਸਿਆ: wsl --install -d <ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ> ਲਈ ਸਟੋਰ ਜਾਂ ਨੈੱਟਵਰਕ ਤੋਂ ਇਮੇਜ ਲੈਣੀ ਪੈਂਦੀ ਹੈ; ਕੰਪਨੀ ਨੈੱਟਵਰਕ, ਪ੍ਰੌਕਸੀ, ਫਾਇਰਵਾਲ ਇਸਨੂੰ ਰੋਕ ਸਕਦੇ ਹਨ।
5. ਅਨੁਮਤੀਆਂ ਨਾਕਾਫੀ: ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਸਥਾਪਿਤ ਕਰਨ ਜਾਂ WSL ਸੈਟਿੰਗਾਂ ਬਦਲਣ ਲਈ ਪ੍ਰਬੰਧਕ ਅਨੁਮਤੀਆਂ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।

TIP

ਸੌਖੇ ਸ਼ਬਦਾਂ ਵਿੱਚ: WSL ਕਮਾਂਡ ਚੱਲਣਾ ≠ Linux ਤਿਆਰ ਹੈ, ਸਿਰਫ "ਪ੍ਰਵੇਸ਼ ਟਿਕਟ" ਮਿਲੀ ਹੈ, ਸਿਸਟਮ ਅਸਲ ਵਿੱਚ ਅਜੇ ਸਥਾਪਿਤ ਨਹੀਂ ਹੋਇਆ।

3. ਸਥਾਪਨਾ ਅਸਫਲਤਾ ਦਾ ਹੱਲ ਕਰੋ

ਅਧਿਆਇ 1 ਅਨੁਸਾਰ ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੂਰੀ ਕਰਨ ਤੋਂ ਬਾਅਦ (ਜਾਂ ਜੇਕਰ ਤੁਹਾਨੂੰ ਲੱਗਦਾ ਹੈ ਕਿ ਤੁਸੀਂ ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੂਰੀ ਕਰ ਲਈ ਹੈ), ਫਿਰ ਵੀ wsl --install ਅਸਫਲ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਹੇਠ ਲਿਖੇ ਕ੍ਰਮ ਵਿੱਚ ਜਾਂਚ ਕਰੋ।

3.1 ਪਹਿਲਾਂ "ਇੱਕ-ਕਲਿੱਕ ਜਾਂਚ" ਕਰੋ

PowerShell ਨੂੰ ਪ੍ਰਬੰਧਕ ਵਜੋਂ ਚਲਾਓ ਅਤੇ ਕ੍ਰਮਵਾਰ ਚਲਾਓ:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ ਜੇਕਰ ਇਹ ਦੋਵੇਂ ਕਮਾਂਡਾਂ ਸਹੀ ਢੰਗ ਨਾਲ ਚੱਲ ਜਾਂਦੀਆਂ ਹਨ, ਤਾਂ WSL ਵਿਕਲਪਿਕ ਕੰਪੋਨੈਂਟ ਸਮਰੱਥ ਹਨ ਅਤੇ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਦੀਆਂ ਸ਼ਰਤਾਂ ਮੂਲ ਰੂਪ ਵਿੱਚ ਪੂਰੀਆਂ ਹੋ ਗਈਆਂ ਹਨ।
• ❌ ਜੇਕਰ ਅਸਫਲ ਹੁੰਦੀਆਂ ਹਨ, ਤਾਂ ਸਿੱਧਾ ਦੱਸ ਦੇਣਗੀਆਂ ਕਿ ਕੀ ਘਾਟ ਹੈ (ਜਿਵੇਂ ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ, Hyper-V, BIOS ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਆਦਿ)।

ਫਿਰ systeminfo ਚਲਾਓ ਅਤੇ ਆਉਟਪੁੱਟ ਵਿੱਚ Virtualization Enabled In Firmware: Yes ਦਿਖਾਈ ਦੇਣਾ ਯਕੀਨੀ ਬਣਾਓ। ਜੇਕਰ ਉਪਰੋਕਤ ਸਾਰੇ ਵਿੱਚ ਕੋਈ ਗਲਤੀ ਨਹੀਂ ਹੈ, ਤਾਂ ਮੂਲ ਰੂਪ ਵਿੱਚ ਨਿਸ਼ਚਿੰਤ ਹੋ ਕੇ wsl --install ਨਾਲ ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਸਥਾਪਿਤ ਕੀਤੀ ਜਾ ਸਕਦੀ ਹੈ।

NOTE

ਕੋਈ ਵੀ ਕਮਾਂਡ 100% ਗਾਰੰਟੀ ਨਹੀਂ ਦੇ ਸਕਦੀ ਕਿ wsl --install ਨਿਸ਼ਚਿਤ ਤੌਰ 'ਤੇ ਸਫਲ ਹੋਵੇਗਾ, ਪਰ ਉਪਰੋਕਤ ਜਾਂਚਾਂ ਇਹ ਪੁਸ਼ਟੀ ਕਰ ਸਕਦੀਆਂ ਹਨ ਕਿ ਸਥਾਪਨਾ ਦੀਆਂ ਸ਼ਰਤਾਂ ਪੂਰੀਆਂ ਹਨ ਜਾਂ ਨਹੀਂ।

3.2 ਹੱਥੀਂ ਜਾਂਚ ਸੂਚੀ

ਜੇਕਰ "ਇੱਕ-ਕਲਿੱਕ ਜਾਂਚ" ਨਾਲ ਸਮੱਸਿਆ ਦਾ ਪਤਾ ਨਹੀਂ ਲੱਗਦਾ, ਤਾਂ ਇੱਕ-ਇੱਕ ਕਰਕੇ ਜਾਂਚ ਕਰੋ:

1. BIOS/ਫਰਮਵੇਅਰ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਚਾਲੂ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ: ਪ੍ਰਬੰਧਕ PowerShell ਵਿੱਚ systeminfo ਚਲਾਓ, ਆਉਟਪੁੱਟ ਵਿੱਚ Virtualization Enabled In Firmware: Yes ਦਿਖਾਈ ਦੇਣਾ ਚਾਹੀਦਾ ਹੈ।
2. Windows ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਚਾਲੂ ਹਨ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   ਦੋਵਾਂ ਕਮਾਂਡਾਂ ਦੀ ਸਥਿਤੀ Enabled ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ।
3. WSL ਉਪਲਬਧ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਂਚੋ: wsl --version ਚਲਾਉਣ 'ਤੇ ਆਮ ਆਉਟਪੁੱਟ ਆਉਣੀ ਚਾਹੀਦੀ ਹੈ; ਜੇਕਰ ਕਮਾਂਡ ਨਾ ਮਿਲਣ ਦਾ ਸੰਕੇਤ ਮਿਲਦਾ ਹੈ, ਤਾਂ WSL ਕੰਪੋਨੈਂਟ ਸਥਾਪਿਤ ਨਹੀਂ ਹਨ, ਕਿਰਪਾ ਕਰਕੇ ਅਧਿਆਇ 1 'ਤੇ ਵਾਪਸ ਜਾਓ।
4. WSL 2 ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਣਾ ਜਾਂਚੋ (ਕਰਨਲ ਅਤੇ ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ): wsl --set-default-version 2 ਚਲਾਉਣ 'ਤੇ ਸਫਲਤਾਪੂਰਵਕ ਵਾਪਸ ਆਉਣਾ ਚਾਹੀਦਾ ਹੈ। ਆਮ ਅਸਫਲਤਾ ਦੇ ਕਾਰਨ: ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ ਸਮਰੱਥ ਨਾ ਹੋਣਾ, ਜਾਂ BIOS ਵਿੱਚ VT-x / AMD-V ਚਾਲੂ ਨਾ ਹੋਣਾ।

3.3 ਆਮ ਅਸਫਲਤਾ ਦੇ ਕਾਰਨਾਂ ਦੀ ਤੁਰੰਤ ਜਾਂਚ

ਸਥਿਤੀ	ਵੇਰਵਾ	ਹੱਲ
BIOS ਵਿੱਚ ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਚਾਲੂ ਨਹੀਂ	ਨਿਸ਼ਚਿਤ ਤੌਰ 'ਤੇ ਅਸਫਲ	ਮੁੜ ਚਾਲੂ ਕਰਕੇ BIOS ਵਿੱਚ VT-x / AMD-V ਚਾਲੂ ਕਰੋ (ਦੇਖੋ 1.2)
Windows 10, 19041 ਤੋਂ ਘੱਟ	wsl --install ਸਮਰਥਿਤ ਨਹੀਂ	ਸਿਸਟਮ ਅੱਪਗਰੇਡ ਕਰੋ (ਦੇਖੋ 1.1)
ਐਂਟਰਪ੍ਰਾਈਜ਼ ਵਾਤਾਵਰਨ ਵਿੱਚ Hyper-V / ਵਰਚੁਅਲਾਈਜ਼ੇਸ਼ਨ ਅਸਮਰੱਥ	ਸੰਭਵ ਤੌਰ 'ਤੇ ਅਸਫਲ	ਸਿਸਟਮ ਪ੍ਰਬੰਧਕ ਨਾਲ ਸੰਪਰਕ ਕਰੋ
ਪੁਰਾਣਾ ਹੋਮ ਐਡੀਸ਼ਨ ਸਿਸਟਮ	ਹੱਥੀਂ ਸਥਾਪਨਾ ਦੀ ਲੋੜ	1.4 ਅਨੁਸਾਰ WSL ਕਰਨਲ ਹੱਥੀਂ ਸਥਾਪਿਤ ਕਰੋ

3.4 ਗਲਤੀ 0xc03a0014: ਵਰਚੁਅਲ ਡਿਸਕ ਸਮਰਥਨ ਪ੍ਰਦਾਤਾ ਨਹੀਂ ਮਿਲਿਆ

ਗਲਤੀ ਸੰਦੇਸ਼: Cannot find a virtual disk support provider for the specified file। ਇਹ Linux ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਦੀ ਸਮੱਸਿਆ ਨਹੀਂ ਹੈ, ਸਗੋਂ Windows ਦਾ VHD/VHDX ਵਰਚੁਅਲ ਡਿਸਕ ਸਟੈਕ ਸਹੀ ਢੰਗ ਨਾਲ ਕੰਮ ਨਹੀਂ ਕਰ ਰਿਹਾ, WSL 2 ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਰਜਿਸਟਰ ਕਰਦੇ ਸਮੇਂ ਅਤੇ ext4.vhdx ਬਣਾਉਣ/ਮਾਊਂਟ ਕਰਨ ਵਿੱਚ ਅਸਫਲ ਹੁੰਦਾ ਹੈ।

ਪਹਿਲਾਂ ਘੱਟੋ-ਘੱਟ ਜਾਂਚ ਕਰੋ: PowerShell ਨੂੰ ਪ੍ਰਬੰਧਕ ਵਜੋਂ ਚਲਾ ਕੇ New-VHD ਟੈਸਟ ਕਰੋ (ਉਦਾਹਰਨ: New-VHD -Path C:\test.vhdx -SizeBytes 1GB)। ਜੇਕਰ ਇਹ ਕਮਾਂਡ ਵੀ ਇਹੀ ਗਲਤੀ ਦਿਖਾਉਂਦੀ ਹੈ, ਤਾਂ ਸਮੱਸਿਆ 100% Windows ਵੱਲ ਹੈ, ਡਿਸਟ੍ਰੀਬਿਊਸ਼ਨ ਨਾਲ ਸੰਬੰਧਿਤ ਨਹੀਂ ਹੈ।

ਹੇਠ ਲਿਖੇ ਕ੍ਰਮ ਵਿੱਚ ਜਾਂਚ ਕਰਕੇ ਮੁਰੰਮਤ ਕਰੋ:

1. Virtual Disk ਸੇਵਾ ਨਹੀਂ ਚੱਲ ਰਹੀ: services.msc ਖੋਲ੍ਹੋ, Virtual Disk ਸੇਵਾ ਲੱਭੋ, ਸਟਾਰਟਅੱਪ ਕਿਸਮ "ਸਵੈਚਾਲਿਤ" (Automatic) ਕਰੋ ਅਤੇ ਉਸਨੂੰ ਸ਼ੁਰੂ ਕਰੋ।

2. WSL / ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਸਮਰੱਥ ਨਹੀਂ (ਜਾਂ ਪ੍ਰਭਾਵੀ ਨਹੀਂ): 1.3 Windows ਸੰਬੰਧੀ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਸਮਰੱਥ ਕਰੋ ਵਿੱਚ ਦਿੱਤੀਆਂ ਕਮਾਂਡਾਂ ਦੁਬਾਰਾ ਚਲਾਓ, ਫਿਰ ਮੁੜ ਚਾਲੂ ਕਰਨਾ ਲਾਜ਼ਮੀ ਹੈ। Windows ਹੋਮ ਐਡੀਸ਼ਨ ਵਿੱਚ ਪੂਰਾ Hyper-V ਨਹੀਂ ਹੁੰਦਾ, ਪਰ WSL 2 ਲਈ ਸਿਰਫ ਵਰਚੁਅਲ ਮਸ਼ੀਨ ਪਲੇਟਫਾਰਮ ਚਾਹੀਦਾ ਹੈ, Hyper-V ਪ੍ਰਬੰਧਨ ਇੰਟਰਫੇਸ ਨਹੀਂ।

3. ਵਰਚੁਅਲ ਡਿਸਕ ਡਰਾਈਵਰ/ਡਿਵਾਈਸ ਗੈਰਹਾਜ਼ਰ: ਡਿਵਾਈਸ ਮੈਨੇਜਰ ਖੋਲ੍ਹੋ, "ਸਿਸਟਮ ਡਿਵਾਈਸ / ਸਟੋਰੇਜ ਕੰਟਰੋਲਰ" ਵਿੱਚ ਹੇਠ ਲਿਖਿਆਂ ਦੀ ਮੌਜੂਦਗੀ ਜਾਂਚੋ:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   ਗੈਰਹਾਜ਼ਰ ਹੋਣ 'ਤੇ hdwwiz.exe ਰਾਹੀਂ ਹੱਥੀਂ ਜੋੜ ਸਕਦੇ ਹੋ (ਸਟੋਰੇਜ ਕੰਟਰੋਲਰ → Microsoft → Microsoft VHD ਲੂਪਬੈਕ ਕੰਟਰੋਲਰ), ਅਤੇ ਯਕੀਨੀ ਬਣਾਓ ਕਿ FsDepends ਸੇਵਾ ਅਸਮਰੱਥ ਨਹੀਂ ਹੈ।

4. ਆਯਾਤ ਕੀਤੀ ਇਮੇਜ WSL ਲੋੜਾਂ ਪੂਰੀਆਂ ਨਹੀਂ ਕਰਦੀ: wsl --import --vhd ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਸਮੇਂ, VHDX ext4 ਫਾਈਲ ਸਿਸਟਮ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ; LUKS ਏਨਕ੍ਰਿਪਟਡ ਡਿਸਕ, ਆਮ raw.img, Live ISO ਜਾਂ NTFS/FAT ਨਾਲ ਫਾਰਮੇਟ ਕੀਤੀ ਖਾਲੀ ਡਿਸਕ ਨਹੀਂ ਹੋ ਸਕਦੀ। .img / .qcow2 / .iso ਨੂੰ ਸਿੱਧਾ wsl --import --vhd ਨਾਲ ਨਹੀਂ ਚਲਾਇਆ ਜਾ ਸਕਦਾ।

5. ਪਾਥ/ਅਨੁਮਤੀਆਂ/ਫਾਈਲ ਸਿਸਟਮ ਸਮੱਸਿਆਵਾਂ: ਟਾਰਗਿਟ ਡਾਇਰੈਕਟਰੀ NTFS ਡਿਸਕ 'ਤੇ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (FAT32/exFAT ਨਹੀਂ ਚੱਲੇਗਾ); ਪਾਥ ਵਿੱਚ ਚੀਨੀ ਅੱਖਰ, ਸਪੇਸ ਅਤੇ ਵਿਸ਼ੇਸ਼ ਚਿੰਨ੍ਹਾਂ ਤੋਂ ਬਚੋ; ਨੈੱਟਵਰਕ ਡਰਾਈਵ, OneDrive, ਕੰਪਰੈੱਸਡ ਫੋਲਡਰ ਤੋਂ ਆਯਾਤ ਨਾ ਕਰੋ; ਨਿਸ਼ਚਿਤ ਤੌਰ 'ਤੇ ਅਸਲ ਪ੍ਰਬੰਧਕ PowerShell ਦੀ ਵਰਤੋਂ ਕਰੋ (ਆਮ ਟਰਮੀਨਲ ਨਹੀਂ)।

6. ਸਿਸਟਮ ਕੰਪੋਨੈਂਟ ਖਰਾਬ: ਕ੍ਰਮਵਾਰ DISM ਅਤੇ SFC ਚਲਾ ਕੇ ਸਿਸਟਮ ਕੰਪੋਨੈਂਟਾਂ ਦੀ ਮੁਰੰਮਤ ਕਰੋ, ਫਿਰ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

ਤੀਜੀ-ਧਿਰ ਵਰਚੁਅਲ ਮਸ਼ੀਨਾਂ (VirtualBox, VMware) ਜਾਂ ਸੁਰੱਖਿਆ ਸਾਫਟਵੇਅਰ ਦੇ ਸੈਂਡਬਾਕਸ/ਹਾਰਡਨਿੰਗ ਫੰਕਸ਼ਨ (ਜਿਵੇਂ 360, ਹੁਓਰੋਂਗ) ਵਰਚੁਅਲ ਡਿਸਕ ਕਾਰਜਾਂ ਵਿੱਚ ਰੁਕਾਵਟ ਪਾ ਸਕਦੇ ਹਨ; ਸਮੱਸਿਆ ਹੱਲ ਕਰਦੇ ਸਮੇਂ ਉਨ੍ਹਾਂ ਨੂੰ ਅਸਥਾਈ ਤੌਰ 'ਤੇ ਬੰਦ ਕਰਕੇ ਦੁਬਾਰਾ ਕੋਸ਼ਿਸ਼ ਕਰੋ।