Příkazová řádka test

Úvod » pokus

19.3.2007 | Marek Mikuš


8. Parametry programu The Bat! na příkazové řádce
Program The Bat! má implementovány možnosti pracovat s parametry na příkazové řádce. Podpora spustitelných batch souborů (*.bat) je také implementována.

Přehled podporovaných příkazů:
Poznámky:
  • Pro oddělení názvů účtů použijte středník ( ; ). Mezi názvy účtů nedělejte mezery, protože mezeru pochopí program jako oddělení příkazů a další parametr by byl ignorován.
  • Obsahuje-li název účtu mezery, umístěte tento název účtu mezi uvozovky (" "). Jsou-li v názvu účtu použity uvozovky, musíte celý název účtu umístit mezi apostrofy ( ' ' ).
  • Je-li vytvořeno více účtů, z nichž je alespoň jeden z nich nastaven jako typ "Uživatel" (Nastavení | Síť a Administrace účtů | Práva účtů), je nutné vložit na řádek také parametr /LOGIN, který přebije úvodní přihlašovací okno při startu programu.

Přijmout nový E-mail – příkazy /CHECK a /CHECKALL
Příkaz /CHECK může být použit jako parametr programu The Bat!, jestliže chcete kontrolovat jeden nebo více účtů.

Příkaz /CHECKALL lze použít pro kontrolu všech účtů v programu a také spojuje příkazy /CHECK* a /SMARTEXIT, protože automaticky ukončí program The Bat!, jestliže nebudou přijaty žádné zprávy.

Syntaxe příkazu /CHECK je následující:

/CHECK<název účtu1>[;název účtu2[;název účtu3[...]]]

Název účtu může být reprezentován následujícími výrazy:
  • Plné jméno účtu.
    Příklad: /CHECK"Marek Mikus 1";"Marek Mikus 2".
    Tyto instrukce říkají programu, aby zkontroloval schránky účtů "Marek Mikus 1" a "Marek mikus 2" (PS. Závorky jsou použity proto, že jsou slova v názvu účtu oddělena mezerou. Nebude-li název účtu obsahovat mezery (například _Mikus_, tak není nutné používat použité závorky)
  • Začátek názvu účtu končící hvězdičkou.
    Příklad: /CHECKMar*
    Tyto instrukce říkají programu, aby zkontroloval schránky všech účtů, u kterých začíná název na písmena "Mar".
  • Hvězdička následovaná koncem názvu účtu.
    Příklad: /CHECK*1
    Tyto instrukce říkají programu, aby zkontroloval schránky všech účtů, které mají na konci názvu číslici "1".
  • Část názvu účtu umístěná mezi hvětdičkami.
    Příklad: /CHECK*Mikus*
    Tyto instrukce říkají programu, aby zkontroloval schránky všech účtů, u kterých obsahuje název účtu slovo "Mikus".
Příklad 1 : /EXIT /CHECKmarek;PASSWORD=heslo

Příklad 2 : /EXIT /CHECK /LOGIN;USER=marek;PASSWORD=heslo

Odeslat E-maily z Fronty - příkazy /SEND a /SENDALL
Příkaz /SEND může být použit jako parametr programu The Bat!, jestliže chcete odeslat nachystané zprávy v Outboxu z jednoho nebo více účtů.

Příkaz /SENDALL lze použít pro odeslání všech nachystaných zpráv v Outboxu všech účtů v programu a také spojuje příkazy /SEND* a /SMARTEXIT, protože automaticky ukončí program The Bat!, jestliže nebudou přijaty žádné zprávy.

Syntaxe příkazu /SEND je následující:

/SEND<název účtu1>[;název účtu2[;název účtu3[...]]]

Název účtu může být reprezentován následujícími výrazy:
  • Plné jméno účtu.
    Příklad: /SEND"Marek Mikus 1";"Marek mikus 2".
    Tyto instrukce říkají programu, aby odeslal všechny zprávy v Outboxu z účtů "Marek Mikus 1" a "Marek mikus 2" (PS. Závorky jsou použity proto, že jsou slova v názvu účtu oddělena mezerou. Nebude-li název účtu obsahovat mezery (například _Mikus_, tak není nutné používat použité závorky)
  • Začátek názvu účtu končící hvězdičkou.
    Příklad: /SENDMar*
    Tyto instrukce říkají programu, aby odeslal zprávy v Outboxu ze všech účtů, u kterých začíná název na písmena "Mar".
  • Hvězdička následovaná koncem názvu účtu.
    Příklad: /SEND*1
    Tyto instrukce říkají programu, aby odeslal zprávy v Outboxu ze všech účtů, které mají na konci názvu číslici "1".
  • Část názvu účtu umístěná mezi hvětdičkami.
    Příklad: /SEND*Mikus*
    Tyto instrukce říkají programu, aby odeslal zprávy v Outboxu ze všech účtů, u kterých obsahuje název účtu slovo "Mikus".

Import zpráv - příkaz /IMPORT
Příkaz /IMPORT slouží k importování e-mailových zpráv do určeného adresáře z formátu RFC-822 nebo z formátu UNIX schránek.

Syntaxe příkazu /IMPORT je následující:

/IMPORT[parametr1[;parametr2[;parametr3[...]]]

Podporované parametry:
  • USER=název účtu nebo U=název účtu
    místo "název účtu" doplňte účet, ve kterém se nachází příslušný adresář. Není-li použit parametr FOLDER, aktivním adresářem bude nastaven adresář "Příchozí".
  • PASSWORD=hodnota nebo P=hodnota
    místo "hodnota" doplňte přístupové heslo k účtu, který je zadán v parametru USER.
  • FOLDER=adresář nebo F=adresář
    místo slova "adresář" doplňte cestu k adresáři, který chcete nastavit jako aktivní po startu programu. Neobsahuje-li zadaná cesta název účtu, program The Bat! bude prohledávat všechny účty a hledat zadaný adresář. První nalezený adresář odpovídající zadanému názvu bude nastaven jako aktivní. Nebude-li adresář nalezen, bude aktivním adresářem nastaven adresář "Příchozí" účtu, zadaného v parametru USER.
  • FILE=maska souborů, IN=maska souborů nebo I=maska souborů
    místo "maska souborů" doplňte souborovou masku s příponou importovaných souborů. Počet těchto parametrů není v příkazu /IMPORT omezen.
  • UNIX nebo X
    tento parametr určuje, že importované zprávy jsou ve formátu UNIX schránek. Není-li tento parametr použit, bude program The Bat! očekávat zprávy ve formátu RFC-822.
  • READ nebo R
    tento parametr určuje, že importované zprávy budou po importování označeny jako přečtené. Není-li tento parametr použit, budou všechny zprávy označeny jako nepřečtené.
  • DELETE, DEL nebo W
    je-li tento parametr použit, budou po úspěšném dokončení importu zpracované soubory smazány.
Příklad 1: /IMPORTU="Mikus";FOLDER="Importovane zpravy\dnes";IN=C:\Files\Test\*.MSG

Příklad 2: /IMPORTF="\\Marek Mikus1\Import\Ctene";UNIX;FILE=C:\Files\Test\*.mbx;READ

Tento příkaz lze také použít pro import Kontaktů z LDIF souboru:
  • B=název Kartotéky
    parametr specifikuje Kartotéku
  • G=rozlišující jméno Skupiny
    parametr specifikuje Skupinu v Kartotéce
  • FILE=soubor
    parametr specifikuje Soubor, ze kterého se mají adresy importovat
  • DELETE
    je-li tento parametr použit, budou po úspěšném dokončení importu zpracované soubory smazány.
Příklad: /IMPORTLdif;DELETE;B="Osobní Kartoteka";G="Kamaradi";File="C:\moje_kartoteka.LDIF"

Export zpráv - příkaz /EXPORT
Příkaz /EXPORT slouží k exportování e-mailových zpráv z určeného adresáře do souborů ve formátu RFC-822 nebo do UNIX schránek. Tento příkaz také umožňuje export adres z Kartotéky do LDIF souboru (je-li zadán parametr LDIF).

Syntaxe příkazu /EXPORT je následující:

/EXPORT[parametr1[;parametr2[;parametr3[...]]]

Podporované parametry:
  • USER=název účtu nebo U=název účtu
    místo "název účtu" doplňte účet, ve kterém se nachází příslušný adresář. Není-li použit parametr FOLDER, aktivním adresářem bude nastaven adresář "Příchozí".
  • PASSWORD=hodnota nebo P=hodnota
    místo "hodnota" doplňte přístupové heslo k účtu, který je zadán v parametru USER.
  • FOLDER=adresář nebo F=adresář
    místo slova "adresář" doplňte cestu k adresáři ve stromové struktuře programu, který chcete exportovat. Neobsahuje-li zadaná cesta název účtu, program The Bat! bude prohledávat všechny účty a hledat zadaný adresář. První nalezený adresář odpovídající zadanému názvu bude nastaven jako aktivní. Nebude-li adresář nalezen, bude aktivním adresářem nastaven adresář "Příchozí" účtu, zadaného v parametru USER.
  • DIR=adresář, D=adresář, OUT=adresář nebo O=adresář
    místo slova "adresář" doplňte cestu k adresáři, do kterého chcete importovat zprávy z programu The Bat!. Je-li výstupním formátem RFC-822, budou zprávy ukládány do souborů s názvem xxxxxxxx.MSG, kde "x" je číslo od 0 do 9. Když začne program The Bat! exportovat zprávy, zjistí, jsou-li již v adresáři uloženy nějaké zprávy. Jestliže ano, začne ukládat nové zprávy s číslem vyšším, než bylo nejvyšší nalezené číslo. Např. bylo-li nejvyšší nalezené číslo v názvu souboru 00001234.MSG, bude mít první nová exportovaná zpráva název 00001235.MSG.
    Je-li výstupním formátem UNIX schránka, doplňte místo slova "soubor" cestu k souboru, do kterého chcete uložit zprávy z programu The Bat!.
  • UNIX nebo X
    tento parametr určuje, že exportované zprávy budou ve formátu UNIX schránek. Není-li tento parametr použit, bude program The Bat! exportovat zprávy do formátu RFC-822.
  • READ nebo R
    je-li tento parametr použit, budou exportovány pouze přečtené zprávy. Není-li tento parametr použit, budou exportovány přečtené i nepřečtené zprávy.
  • UNREAD nebo A
    je-li tento parametr použit, budou exportovány pouze nepřečtené zprávy.
  • REPLIED nebo RE
    je-li tento parametr použit, budou exportovány pouze odpovězené zprávy. Není-li tento parametr použit, budou exportovány odpovězené i nezodpovězené zprávy.
  • UNREPLIED nebo NR
    je-li tento parametr použit, budou exportovány pouze nezodpovězené zprávy.
  • PARKED nebo PR
    je-li tento parametr použit, budou exportovány pouze zaparkované zprávy. Není-li tento parametr použit, budou exportovány zaparkované i nezaparkované zprávy.
  • UNPARKED nebo UP
    je-li tento parametr použit, budou exportovány pouze nezaparkované zprávy.
  • MAXAGE=stáří zprávy, AGE=stáří zprávy nebo A=stáří zprávy
    tento parametr určuje, že zprávy, které jsou starší než je udaný počet dnů v parametru "stáří zprávy" nebudou exportovány. Není-li tento parametr použit, budou exportovány všechny zprávy.
  • START=číslo nebo S=číslo
    místo slova "číslo" doplňte pořadové číslo zprávy, kterou se bude začínat při exportu Základny Zpráv. Zprávy před tímto číslem nebudou exportovány. Bude-li uvedené číslo záporné, bude program The Bat! začínat zprávou s tímto pořadovým číslem od konce, např. bude-li místo slova "číslo" dosazeno -5, začne program The Bat! export na 5. zprávě od konce Základny Zpráv.
  • END=číslo nebo E=číslo
    místo slova "číslo" doplňte pořadové číslo zprávy, kterou se bude končit při exportu Základny Zpráv. Zprávy za tímto číslem nebudou exportovány. Bude-li uvedené číslo záporné, bude program The Bat! končit zprávou s tímto pořadovým číslem od konce, např. bude-li místo slova "číslo" dosazeno -2, skončí program The Bat! export na 2. zprávě od konce Základny Zpráv.
  • OVERRIDE nebo V
    (funkční pouze s parametrem UNIX nebo LDIF) je-li tento parametr použit, bude výstupní soubor v nastaveném adresáři přepsán (existuje-li). Není-li tento parametr použit, budou zprávy připsány na konec stávajícího souboru.
  • LDIF
    je-li tento parametr použit, budou se exportovat adresy z Kartotéky místo zpráv. Parametrem OUT musí být nastaven soubor, do kterého se budou adresy ve formátu LDIF exportovat.
  • ADDRESSBOOK=hodnota, AB=hodnota nebo BOOK=hodnota
    (funkční pouze s parametrem LDIF) místo slova "hodnota" vložte jméno Kartotéky, soubor Kartotéky nebo celou cestu k souboru, ve kterém je Kartotéka, kterou chcete exportovat, obsažena. Není-li Kartotéka specifikována, The Bat! použije výchozí Kartotéku.
  • GROUP=hodnota nebo G=hodnota
    (funkční pouze s parametrem LDIF) místo slova "hodnota" vložte Rozlišující jméno Skupiny, která má být exportována. Nebude-li nastavena Kartotéka, The Bat! prohledá všechny a použije první, která bude vyhovovat nastavené Skupině.
Příklad 1: /EXPORTU="Marek Mikus 1";F="Firma\Test";DIR=C:\Files\Testy\;S=-20

Příklad 2: /EXPORTF=\\MarekMikus1\Buss\Tridene;UNIX;O=C:\Files\Testy\Mail.mbx;UNREAD

Příklad 3: /EXPORTLDIF;AB="Osobni Kartoteka";Group="Kamaradi";O="C:\kamaradi.LDIF"

Příklad 4: /EXPORTLDIF;Group="Pratele";O="C:\moji_pratele.LDIF"

Nastavení aktivního adresáře - příkaz /FOCUS
Příkaz /FOCUS slouží k nastavení aktivního adresáře po spuštění programu The Bat!. Tento příkaz je vhodný po spuštění programu The Bat!.

Syntaxe příkazu /FOCUS je následující:

/FOCUS[parameter1[;parameter2[;parameter3[...]]]

Podporované parametry:
  • USER=název účtu nebo U=název účtu
    místo "název účtu" doplňte účet, ve kterém se nachází příslušný adresář. Není-li použit parametr FOLDER, aktivním adresářem bude nastaven adresář "Příchozí".
  • PASSWORD=hodnota nebo P=hodnota
    místo "hodnota" doplňte přístupové heslo k účtu, který je zadán v parametru USER.
  • FOLDER=adresář nebo F=adresář
    místo slova "adresář" doplňte cestu k adresáři, který chcete nastavit jako aktivní po startu programu. Neobsahuje-li zadaná cesta název účtu, program The Bat! bude prohledávat všechny účty a hledat zadaný adresář. První nalezený adresář odpovídající zadanému názvu bude nastaven jako aktivní. Nebude-li adresář nalezen, bude aktivním adresářem nastaven adresář "Příchozí" účtu, zadaného v parametru USER.
Příklad: /FOCUSU="Marek Mikus 1";F=thebat\tbudl

Jednoduché vytvoření Nové zprávy - příkaz mailto:
Použijete-li příkaz mailto:, tak bude ihned po startu programu otevřeno okno editoru společně s E-mailovou adresou, zadanou za příkazem mailto:.

Syntaxe příkazu mailto: je následující:

mailto:e-mailová adresa
mailto: "Jméno a Příjmení <e-mailová adresa>"

Příklad 1: mailto:info@thebat.cz
Tyto instrukce říkají programu, aby po startu programu vytvořil okno editoru a do pole "Příjemce" doplnil E-mailovou adresu info@thebat.cz.

Příklad 2: mailto:"Marek Mikuš <info@thebat.cz>"
Tyto instrukce říkají programu, aby po startu programu vytvořil okno editoru a do pole "Příjemce" doplnil "Marek Mikuš <info@thebat.cz>".

Jako šablona pro vytoření Nové zprávy bude použita šablona toho účtu, který má nastavenu volbu "Účet | Nastavení | Tento účet je výchozí pro odkazy mailto: ve WWW prohlížeči". Na výchozí šablonu nemá vliv nastavení aktivního adresáře, ale nastavení v menu "Účet | Nastavení | Šablony zpráv | Nová zpráva".

Příkaz mailto: je standardně používán jako URL identifikátor a je popsán v RFC 2368. Příkaz mailto: také obvykle používají WWW prohlížeče, které po kliknutí na odkaz mailto: spustí nadefinovaný E-mailový klient s touto adresou.

Nastavitelné vytvoření Nové zprávy - příkaz /MAIL
Příkaz /MAIL slouží k automatickému vytvoření zprávy pomocí nastavené šablony, která může mít přiloženy soubory a může mít zadány adresy příjemců. Příkaz je vhodný tam, kde se posílá hodně podobných zpráv nebo kde není potřeba do zprávy moc zasahovat.

Syntaxe příkazu /MAIL je následující:

/MAIL[parametr1[;parametr2[;parametr3[...]]]

Podporované parametry:
  • USER=název účtu nebo U=název účtu
    místo "název účtu" doplňte účet, ve kterém se nachází příslušný adresář. Není-li použit parametr FOLDER, aktivním adresářem bude nastaven adresář "Příchozí".
  • PASSWORD=hodnota nebo P=hodnota
    místo "hodnota" doplňte přístupové heslo k účtu, který je zadán v parametru USER.
  • FOLDER=adresář nebo F=adresář
    místo slova "adresář" doplňte cestu k adresáři, který chcete nastavit jako aktivní po startu programu. Neobsahuje-li zadaná cesta název účtu, program The Bat! bude prohledávat všechny účty a hledat zadaný adresář. První nalezený adresář odpovídající zadanému názvu bude nastaven jako aktivní. Nebude-li adresář nalezen, bude aktivním adresářem nastaven adresář "Příchozí" účtu, zadaného v parametru USER.
  • TEMPLATE=soubor nebo T=soubor
    místo "soubor" doplňte cestu k souboru, který obsahuje šablonu zpráv, která má být použita pro vytvořenou zprávu. Jako výchozí je považována šablona nastavená v aktivním adresáři popřípadě aktivním účtu.
  • TO=E-mailová adresa
    místo "E-mailová adresa" doplňte primárního příjemce vytvořené zprávy. Chcete-li zprávu adresovat na více adres, použijte parametr TEMPLATE a makra %TO, %CC a %BCC.
  • SUBJECT=předmět nebo S=předmět
    místo "předmět" doplňte předmět nově vytvořené zprávy. Ekvivalentem pro tento parametr je makro %SUBJECT použité v šabloně zpráv.
  • TEXT=soubor, CONTENTS=soubor nebo C=soubor
    místo "soubor" doplňte cestu k souboru, který se vloží do vytvořené zprávy zprávy jako text. Ekvivalentem pro tento parametr je makro %PUT použité v šabloně zpráv.
  • ATTACH=soubor, FILE=soubor nebo A=soubor
    místo "soubor" doplňte cestu k souboru, který bude přiložen ke zprávě jako "příloha". Ekvivalentem pro tento parametr je makro %ATTACHFILE použité v šabloně zpráv.
  • SEND
    je-li tento parametr použit, bude zpráva po dokončení ihned odeslána.
  • QUEUE
    je-li tento parametr použit, bude zpráva po dokončení uložena do Fronty adresáře Outbox.
  • EDIT
    je-li tento parametr použit, bude po spuštění programu otevřeno okno Editoru s nastavením dle výše použitých parametrů
    Příklad 1: /MAILU=marek;TO=info@thebat.cz;S=Test;TEXT=C:\TEST\TEST.MSG

    Příklad 2: /MAILF=\\MyAccount\Test;TO=info@thebat.cz

Přidání nového účtu - příkaz /ADD
Jestliže potřebujete přidat hromadně účet se stejným nastavením na větším množství počítačů, je tento parametr určený přesně pro Vás.

Syntaxe příkazu /ADD je následující:

/ADD;Parametry

Možné parametry jsou:
  • USER="název účtu"
    tento parametr specifikuje název účtu.
  • InServer="adresa_serveru"
    adresa v tomto parametru specifikuje příchozí POP/IMAP server
  • OutServer="adresa_serveru"
    adresa v tomto parametru specifikuje odchozí SMTP server
  • InUser="jméno"
    tímto parametrem se specifikuje jméno schránky na příchozím POP/IMAP serveru
  • Password="heslo"
    tímto parametrem se specifikuje heslo ke schránce na příchozím POP/IMAP serveru
  • OutUser="jméno"
    tímto parametrem se specifikuje jméno schránky při SMTP ověření (pokud je jiné než jméno specifikované v parametru InUser)
  • OutPassword="heslo"
    tímto parametrem se specifikuje heslo ke schránce při SMTP ověření (pokud je jiné než heslo specifikované v parametru Password)
  • Combined
    parametr aktivuje funkci "Kombinované odesílání" v Nastavení účtu, sekce "Přenos"
  • Deferred
    parametr aktivuje funkci "Později" v Nastavení účtu, sekce "Přenos | Odesílat zprávy"
  • IMAP
    parametr aktivuje jako protokol pro Příchozí zprávy IMAP4
  • FileDir[="cesta k adresáři"]
    parametr určující, že budou přílohy ukládány v samostatném adresáři
  • Template="cesta_k_souboru"
    cesta k souboru na disku, který obsahuje šablonu pro Nové zprávy
  • ReplyTemplate="cesta_k_souboru"
    cesta k souboru na disku, který obsahuje šablonu pro Odpovědi
  • ForwardTemplate="cesta_k_souboru"
    cesta k souboru na disku, který obsahuje šablonu pro Předání zprávy
  • KeepDays=dnů
    parametr nastavuje počet dnů u funkce "Nechat zprávy na serveru po dobu"
  • DelReceived
    parametr nastavuje jako aktivní funkci "Odstranit zprávy ze serveru"
  • FromAddr="e-mailová_adresa"
    parametr nastavuje E-mailovou adresu odesílatele v poli "Od koho"
  • FromName="jméno"
    parametr nastavuje Celé jméno odesílatele v poli "Od koho"
  • ReplyAddr="e-mailová_adresa"
    parametr nastavuje E-mailovou adresu odesílatele v poli "Odpovědět na"
  • ReplyName="jméno"
    parametr nastavuje Celé jméno odesílatele v poli "Odpovědět na"
  • DelTrashServer
    parametr aktivuje funkci "Odstranit zprávy ze serveru, budou-li smazány z Koše"
  • SizeLimit=N K bytů
    parametr nastavuje limit u funkce "Přijmout pouze hlavičku, je-li zpráva větší než"
  • PortPOP="číslo_portu"
    parametr specifikuje číslo portu Příchozího POP serveru
  • PortSMTP="číslo_portu"
    parametr specifikuje číslo portu Odchozího SMTP serveru
  • PortIMAP="číslo_portu"
    parametr specifikuje číslo portu Příchozího IMAP serveru
    Příklad:
    /ADD;USER=mikus;InServer="pop.server.cz";InUser="mikus";Password="heslo"

Spouštění více příkazů ze souboru - příkaz /BATCH
Jestliže potřebujete často spustit více příkazů najednou, ušetří Vám příkaz /BATCH hodně času. Příkaz /BATCH umožňuje provedení příkazů definovaných v textovém souboru. Každý příkaz musí být uveden na samostatném řádku.

Syntaxe příkazu /BATCH je následující:

/BATCH:<cesta k souboru>

Příklad: /BATCH:C:\The Bat!\CheckMail.bat
V souboru "CheckMail.bat" budou uvedeny následující příkazy:

/CHECKmarek
/SENDmarek
/SMARTEXIT

Tyto instrukce říkají programu, že má provést příkazy uvedené v souboru "CheckMail.bat", tzn. přijmout nové E-maily pro účet "marek", odeslat všechny nachystané E-maily z adresáře Outbox účtu "marek" a po dokončení přenosu program ukončit.

Ostatní příkazy - /MINIMIZE, /EXIT, /SMARTEXIT, /NOLOGO a /REFRESHAB
Všechny níže uvedené příkazy lze využít při spuštění programu.

Příkaz /EXIT ukončí program The Bat!, jakmile je přenos dokončen.

Příkaz /SMARTEXIT ukončí program, je-li ukončeno přijímání/odesílání zpráv a jestliže nebyly žádné nové zprávy přijmuty.

Příkaz /MINIMIZE zminimalizuje program The Bat!.

Příkaz /NOLOGO se používá při startu programu a zakáže zobrazení úvodního okna s logem a verzí. Tento příkaz je vhodný, jestliže se program The Bat! spouští automaticky při startu Windows.

Příkaz /REFRESHAB se používá pro ruční obnovení okna Kartotéky při změnách prováděných na pozadí.

Zpět na aktuality »