مرجع سطر أوامر مولد عميل الاتصال

ClientGenerator.exe يدعم وضعين صامتين (غير تفاعليين) من سطر الأوامر:

1. وضع التوليد — ينشئ جديداً .اتصل ملف العميل من الصفر.
2. وضع التحرير ( -تحرير ) — تعديل موجود .اتصل يكتب الملف ويخزن النتيجة في ملف جديد.

يتم اختيار الوضع تلقائيًا بناءً على ما إذا كان -تحرير الراية موجودة.

وضع التوليد

يخلق جديداً .اتصل ملف العميل.

صيغة

ClientGenerator.exe -name "clientname.connect" [-location "output folder"] -server my.server.com -user login -psw password [...]

المعلمات

مثال

ClientGenerator.exe -name "clientname.connect" -server my.server.com -server 127.0.0.1 -user login -psw password

وضع التحرير

يعدل موجودًا .اتصل ملف (الإدخال) ويكتب النتيجة المعدلة إلى جديد .اتصل ملف (الإخراج). يتطلب الـ -تحرير علم.

صيغة

ClientGenerator.exe -edit -path "input file path" -output "output file path" [-user user] [-psw psw] [-domain domain] [-mode remoteapp|remotedesktop]

المعلمات

مثال

ClientGenerator.exe -edit -path "C:\Clients\template.connect" -output "C:\Clients\output.connect" -user jdoe -mode remoteapp

رموز الخروج

أمثلة على استخدام PowerShell

إنشاء عميل واحد

& ".\ClientGenerator.exe" -name "clientname.connect" -server "my.server.com" -user "login" -psw "password"

توليد عدة عملاء في حلقة (من قائمة CSV)

نظرًا لـ عملاء.csv ملف:

Name,Server,User,Password
marie.connect,srv01.company.com,marie,P@ssw0rd1
edgar.connect,srv02.company.com,edgar,P@ssw0rd2
rose.connect,srv03.company.com,rose,P@ssw0rd3

$clients = Import-Csv -Path ".\clients.csv"

foreach ($client in $clients) {
    Write-Host "Generating client: $($client.Name)"

    & ".\ClientGenerator.exe" `
        -name $client.Name `
        -server $client.Server `
        -user $client.User `
        -psw $client.Password

    if ($LASTEXITCODE -ne 0) {
        Write-Warning "Generation failed for $($client.Name) (exit code $LASTEXITCODE)"
    }
}

توليد عملاء لمجموعة من أسماء المستخدمين

$server = "my.server.com"

1..10 | ForEach-Object {
    $user = "user{0:D2}" -f $_
    $name = "$user.connect"

    Write-Host "Generating client for $user..."

    & ".\ClientGenerator.exe" -name $name -server $server -user $user -psw "TempP@ss123"
}

تحرير عدة موجودات .اتصل الملفات في حلقة

يطبق نفس تحديث النطاق والوضع على كل .اتصل ملف في مجلد.

$inputFolder  = "C:\Clients\ToUpdate"
$outputFolder = "C:\Clients\Updated"

New-Item -ItemType Directory -Path $outputFolder -Force | Out-Null

Get-ChildItem -Path $inputFolder -Filter "*.connect" | ForEach-Object {
    $outputPath = Join-Path $outputFolder $_.Name

    Write-Host "Editing: $($_.Name)"

    & ".\ClientGenerator.exe" `
        -edit `
        -path $_.FullName `
        -output $outputPath `
        -domain "CORP" `
        -mode "remoteapp"

    if ($LASTEXITCODE -eq 0) {
        Write-Host "  -> Success" -ForegroundColor Green
    } else {
        Write-Warning "  -> Failed (exit code $LASTEXITCODE)"
    }
}

تحرير العملاء بإعدادات لكل ملف (من CSV)

نظرًا لـ تعديلات.csv ملف:

InputPath,OutputPath,User,Mode
C:\Clients\a.connect,C:\Clients\a-updated.connect,alice,remoteapp
C:\Clients\b.connect,C:\Clients\b-updated.connect,bob,remotedesktop

$edits = Import-Csv -Path ".\edits.csv"

foreach ($edit in $edits) {
    & ".\ClientGenerator.exe" `
        -edit `
        -path $edit.InputPath `
        -output $edit.OutputPath `
        -user $edit.User `
        -mode $edit.Mode

    if ($LASTEXITCODE -ne 0) {
        Write-Warning "Failed to edit $($edit.InputPath)"
    }
}

ملاحظة: $LASTEXITCODE موثوق به فقط بعد استدعاء تنفيذي أصلي. تجنب تشغيل أوامر أخرى بين ClientGenerator.exe الاتصال والتحقق.