Start-BitsTransfer: تعيين بيانات اعتماد الوكيل في مهمة BITS

يعرض Start-BitsTransfer إعدادات الوكيل على النقل نفسه. وعند توفر وحدة Windows BitsTransfer، يمكن توفير مسار صريح مُصادَق عليه على النحو التالي:

$transfer = @{
    Source = 'https://downloads.example.net/file.zip'
    Destination = 'C:\Downloads\file.zip'
    ProxyUsage = 'Override'
    ProxyList = 'proxy.example.net:8080'
    ProxyAuthentication = 'Negotiate'
    ProxyCredential = (Get-Credential)
    ErrorAction = 'Stop'
}
Start-BitsTransfer @transfer

العناوين والمسار المحلي أمثلة فقط. اختر طريقة المصادقة التي يدعمها الوكيل؛ وطريقة Negotiate هي المختارة في هذا المقتطف. أما Override فتخبر المهمة بأن تستخدم قائمة الوكلاء المزوَّدة بدلاً من سياسة الاكتشاف الافتراضية.

يوفر طلب بيانات الاعتماد حساب الوكيل لهذه المهمة. والقرار بالتجاوز الذي يُحصل عليه من WebClient لا يحدد ما إذا كانت BITS ستحتاج إلى مصادقة، فللـ BITS إعداد مهمة وتبادل مصادقة خاصان به.

يتيح -ErrorAction Stop للمستدعي معالجة خطأ cmdlet عبر تدفق try/catch في PowerShell. احتفظ بسجل الخطأ الأصلي عند الإبلاغ عن نقل فاشل. والاكتفاء بمطابقة عبارة إنجليزية مثل “Proxy authentication is required” يربط معالجة الأخطاء بالرسالة المعروضة بدلاً من معلومات الخطأ الفعلية للمهمة.