Start-BitsTransfer : définir les informations d’identification du proxy sur le travail BITS

Utilisez les paramètres de proxy de Start-BitsTransfer pour fournir un itinéraire, une méthode d’authentification et des informations d’identification au transfert.

Start-BitsTransfer expose la configuration du proxy sur le transfert lui-même. Lorsque le module Windows BitsTransfer est disponible, un itinéraire authentifié explicite peut être fourni comme suit :

$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

Les adresses et le chemin local sont des exemples. Choisissez la méthode d’authentification prise en charge par le proxy ; Negotiate est la méthode retenue dans cet extrait. Override demande au travail d’utiliser la liste de proxys fournie plutôt que sa stratégie de découverte par défaut.

L’invite d’identification fournit le compte de proxy pour ce travail. Une décision de contournement obtenue depuis un WebClient ne détermine pas si BITS aura besoin d’une authentification. BITS dispose de sa propre configuration de travail et de son propre échange d’authentification.

-ErrorAction Stop permet à l’appelant de traiter une erreur de cmdlet avec le flux try/catch de PowerShell. Conservez l’enregistrement d’erreur d’origine lorsque vous signalez un transfert échoué. Ne faire correspondre qu’une phrase anglaise comme “Proxy authentication is required” lie la gestion des erreurs au message affiché plutôt qu’aux informations d’erreur réelles du travail.

Articles similaires