Start-BitsTransfer: proxyreferenties instellen op de BITS-taak

Gebruik de proxyparameters van Start-BitsTransfer om een route, verificatiemethode en referenties voor de overdracht op te geven.

Start-BitsTransfer legt de proxyconfiguratie op de overdracht zelf bloot. Als de module Windows BitsTransfer beschikbaar is, kan een expliciete geauthenticeerde route als volgt worden opgegeven:

$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

De adressen en het lokale pad zijn voorbeelden. Kies de verificatiemethode die de proxy ondersteunt; in dit fragment is Negotiate gekozen. Override laat de taak de opgegeven proxylijst gebruiken in plaats van het standaardbeleid voor detectie.

De referentieprompt levert het proxyaccount voor deze taak. Een omzeilingsbeslissing van een WebClient bepaalt niet of BITS verificatie nodig heeft. BITS heeft een eigen taakconfiguratie en een eigen verificatie-uitwisseling.

-ErrorAction Stop laat de aanroeper een cmdlet-fout afhandelen met de try/catch-stroom van PowerShell. Bewaar de oorspronkelijke foutrecord wanneer u een mislukte overdracht meldt. Alleen een Engelse zin zoals “Proxy authentication is required” vergelijken koppelt foutafhandeling aan het weergegeven bericht in plaats van aan de werkelijke foutinformatie van de taak.

Gerelateerde artikelen