コンテンツにスキップ

接続クライアントジェネレーター - コマンドラインリファレンス

接続クライアントジェネレーターコマンドラインリファレンス

ClientGenerator.exe 二つのサイレント(非対話型)コマンドラインモードをサポートしています:

  1. 生成モード — 新しいを作成します 接続 クライアントファイルをゼロから作成します。
  2. 編集モード ( -編集 ) — 既存のものを編集します 接続 ファイルに書き込み、結果を新しいファイルに保存します。

モードは、選択されたかどうかに基づいて自動的に選択されます。 -編集 フラグが存在します。


生成モード

新しい作成 接続 クライアントファイル。

構文

ターミナルウィンドウ
ClientGenerator.exe -name "clientname.connect" [-location "output folder"] -server my.server.com -user login -psw password [...]

パラメータ

パラメータ 必要 説明
-名前 いいえ 生成された名前 接続 ファイル。デフォルトは Client- .connect 省略された場合。
-場所 いいえ ファイルが生成されるフォルダー。デフォルトでは現在のユーザーのデスクトップです。
(すべての他のパラメータ) 依存します クライアント生成ロジックにそのまま転送されました( -サーバー , ユーザー , -psw 、など)。

ターミナルウィンドウ
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]

パラメータ

パラメータ 必要 説明
-編集 はい 編集モードを有効にします。
-パス はい 入力へのパス 接続 ファイル。必ず終了すること 接続 .
出力 はい 出力へのパス 接続 ファイル。必ず終了すること 接続 .
ユーザー 少なくとも一つの ユーザー , -psw , -ドメイン , モード 必要です 新しいユーザー名の値。
-psw 上記を参照してください 新しいパスワードの値。
-ドメイン 上記を参照してください 新しいドメイン値。
モード 上記を参照してください 接続モード。必須です リモートアプリ または リモートデスクトップ .

ターミナルウィンドウ
ClientGenerator.exe -edit -path "C:\Clients\template.connect" -output "C:\Clients\output.connect" -user jdoe -mode remoteapp

終了コード

コード 意味
0 操作が正常に完了しました。
非ゼロ エラーで操作が完了しました — 詳細はコンソール出力を参照してください。
1 無効または欠落しているコマンドライン引数。

PowerShellの使用例

単一のクライアントを生成する

ターミナルウィンドウ
& ".\ClientGenerator.exe" -name "clientname.connect" -server "my.server.com" -user "login" -psw "password"

CSVリストからループ内で複数のクライアントを生成する

与えられた clients.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からのファイルごとの設定でクライアントを編集する

与えられた edits.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 コールとチェック。