Start-BitsTransfer: Proxyanmeldeinformationen für den BITS-Auftrag festlegen

Start-BitsTransfer legt die Proxykonfiguration an der Übertragung selbst offen. Steht das Modul Windows BitsTransfer zur Verfügung, lässt sich eine explizit authentifizierte Route so vorgeben:

$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

Die Adressen und der lokale Pfad sind Beispiele. Wählen Sie die Authentifizierungsmethode, die der Proxy unterstützt; in diesem Ausschnitt ist Negotiate gewählt. Override weist den Auftrag an, die angegebene Proxyliste statt seiner standardmäßigen Ermittlungsrichtlinie zu verwenden.

Die Anmeldeaufforderung liefert das Proxykonto für diesen Auftrag. Eine Umgehungsentscheidung aus einem WebClient belegt nicht, ob BITS eine Authentifizierung benötigt. BITS hat eine eigene Auftragskonfiguration und einen eigenen Authentifizierungsaustausch.

-ErrorAction Stop ermöglicht dem Aufrufer, einen Cmdlet-Fehler über den try/catch-Ablauf von PowerShell zu behandeln. Bewahren Sie den ursprünglichen Fehlerdatensatz auf, wenn Sie eine fehlgeschlagene Übertragung melden. Wer nur auf eine englische Formulierung wie “Proxy authentication is required” prüft, bindet die Fehlerbehandlung an die gerenderte Meldung statt an die tatsächlichen Fehlerinformationen des Auftrags.