Start-BitsTransfer: definir as credenciais de proxy na tarefa BITS

O Start-BitsTransfer expõe a configuração de proxy na própria transferência. Com o módulo Windows BitsTransfer disponível, uma rota autenticada explícita pode ser fornecida da seguinte forma:

$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

Os endereços e o caminho local são exemplos. Escolha o método de autenticação suportado pelo proxy; neste trecho foi escolhido Negotiate. O Override indica à tarefa que use a lista de proxies fornecida em vez da sua política de descoberta predefinida.

O pedido de credenciais fornece a conta de proxy para esta tarefa. Uma decisão de ignorar obtida de um WebClient não determina se o BITS precisará de autenticação. O BITS tem a sua própria configuração de tarefa e a sua própria troca de autenticação.

O -ErrorAction Stop permite que quem chama trate um erro do cmdlet com o fluxo try/catch do PowerShell. Guarde o registo de erro original ao comunicar uma transferência falhada. Corresponder apenas a uma frase em inglês como “Proxy authentication is required” liga o tratamento de erros à mensagem apresentada em vez da informação real do erro da tarefa.