Start-BitsTransfer: impostare le credenziali proxy sul processo BITS

Start-BitsTransfer espone la configurazione del proxy sul trasferimento stesso. Con il modulo Windows BitsTransfer disponibile, è possibile fornire un percorso autenticato esplicito come segue:

$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

Gli indirizzi e il percorso locale sono esempi. Scegliete il metodo di autenticazione supportato dal proxy; in questo frammento è stato scelto Negotiate. Override indica al processo di usare l’elenco di proxy fornito invece dei criteri di individuazione predefiniti.

La richiesta delle credenziali fornisce l’account proxy per questo processo. Una decisione di bypass ottenuta da un WebClient non stabilisce se BITS richiederà l’autenticazione. BITS dispone di una propria configurazione del processo e di un proprio scambio di autenticazione.

-ErrorAction Stop consente al chiamante di gestire un errore del cmdlet con il flusso try/catch di PowerShell. Conservate il record di errore originale quando segnalate un trasferimento non riuscito. Far corrispondere solo una frase inglese come “Proxy authentication is required” lega la gestione degli errori al messaggio visualizzato anziché alle informazioni effettive sull’errore del processo.