le commande serveur Cet outil permet d’accéder à des dizaines d’opérations de serveur allant de la gestion des utilisateurs à la maintenance du système, en passant par la manipulation de compte et le contrôle de l’imprimante. le commande serveur outil est idéal pour contrôler la PaperCut NG / MF via la ligne de commande ou en automatisant via des scripts.
Quelques exemples de la manière dont un administrateur peut utiliser le commande serveur outil:
-
Planification des sauvegardes en ligne et des instantanés de données.
-
Planification de tâches de synchronisation d'utilisateurs et / ou de groupes.
-
Automatisation de l'ajout de nouveaux utilisateurs après l'ajout des comptes au réseau.
-
Effectuer des transactions de compte, telles que l'ajout de fonds / de quotas aux comptes d'utilisateurs.
-
Automatisation de la création de compte utilisateur à l'aide de scripts personnalisés.
-
Désactiver / activer les imprimantes.
-
Désactiver / activer l'impression pour les utilisateurs.
-
Contrôle des niveaux de restriction utilisateur.
-
Gestion des comptes partagés.
-
Désactivation / activation de SNMPV3 sur les imprimantes et les périphériques.
le commande serveur programme est un outil de ligne de commande. Il accepte les commandes en tant qu'arguments et affiche les résultats de la commande sur la console (sortie standard). Pour des raisons de sécurité, seuls les utilisateurs ayant un accès en lecture à la server.properties (normalement seulement le Administrateurs groupe) ont le droit d'exécuter les commandes.
Utilisation typique sur un système Windows:
Ajoutez 10,00 $ à un utilisateur nommé 'testuser':
C: > cd [app-path] serveur bin win
C: > commande du serveur ajuster-utilisateur-compte-solde "testuser" 10.00 "Ajout de 10,00 $ à votre compte"
<div class = "NoteDiv" data-mc-autonum = "Remarque: ">Remarque:
La barre oblique inverse indique que le texte doit être sur la même ligne.
Accéder aux commandes du serveur à distance
Les commandes de serveur peuvent également être appelées à distance à l'aide d'outils de commande à distance standard.
Sur Windows
Utilisez PsExec – un programme de commande à distance fourni par l'équipe Sysinternals de Microsoft. Par exemple (sur une seule ligne):
psexec.exe \ remoteserver
"C: Program Files PaperCut NG / MF server bin win server-command.exe "
disable-printer printrv1 labprinter -1
Sous Linux / Novell / Mac
Utilisez SSH – un programme de commande / shell distant sécurisé. Vous pouvez exécuter SSH de manière non interactive dans des scripts à l’aide d’une clé publique autorisée ajoutée sous papercut la liste ~ / .ssh / registered_keys du compte. Par exemple (sur une seule ligne):
ssh papercut@remoteserver
"/maison/papercut/ server / bin / linux-x64 / server-command
disable-printer printrv1 labprinter -1 "
Commandes disponibles
Une liste complète des commandes est disponible via commande-serveur –help.
Utilisation: commande-serveur COMMAND [ARGS…]
COMMAND: Le nom de la commande du serveur.
ARGS: Une liste d'arguments à fournir à la commande.
COMMANDES:
l'utilisateur existe
Testez pour voir si un utilisateur existe.
– le nom d'utilisateur à tester.
obtenir-solde-compte-utilisateur [[[[]
Obtenir le solde du compte actuel d'un utilisateur.
– le nom d'utilisateur de l'utilisateur.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs sont activés. Laissez vide pour un solde total.
get-user-property
Obtient une propriété de l'utilisateur.
– Le nom d'utilisateur.
– le nom de la propriété à obtenir. Les propriétés valides incluent:
account-selection.mode – mode de sélection du compte actuel de l'utilisateur
account-selection.can-charge-personal – Indique si l'utilisateur peut ou non imputer des frais sur son compte personnel
account-selection.can-charge-shared-from-list – indique si l'utilisateur peut ou non facturer à un utilisateur sélectionné dans une liste
account-selection.can-charge-shared-by-pin – Indique si l'utilisateur peut ou non facturer un compte partagé, sélectionné par code PIN
auto-release-jobs – indique si les tâches de l'utilisateur seront toujours publiées lors de la connexion au périphérique
auto-shared-account – nom du compte partagé automatiquement sélectionné par l'utilisateur
solde – solde du compte courant de l'utilisateur
carte-pin – le numéro de carte de l'utilisateur
default-shared-account – nom du compte partagé par défaut de l'utilisateur
département – le département de l'utilisateur
disabled-net – si l'accès Internet de l'utilisateur est actuellement désactivé (obsolète)
disabled-print – si l'impression de l'utilisateur est actuellement désactivée
règles de non-application-d'imprimante-de filtre – que les paramètres de filtre de l'imprimante soient ou non appliqués aux travaux de l'utilisateur
ne pas archiver – si les travaux de l'utilisateur seront archivés
pas-hold-jobs-in-release-station – Indique si le travail de l'utilisateur contournera les files d'attente de publication
email – l'email de l'utilisateur
nom complet – nom complet de l'utilisateur
home – le dossier de base de l'utilisateur (chemin UNC à double guillemet)
net-stats.data-mb – les données Internet (en Mo) utilisées par l'utilisateur (obsolète)
net-stats.time-hours – le temps Internet (en heures) utilisé par l'utilisateur (obsolète)
notes – notes pour l'utilisateur
office – le bureau de l'utilisateur
other-emails – les autres emails de l'utilisateur
découvert découvert – pour, la limite de découvert de l’utilisateur
primary-card-number – le numéro de carte principal de l'utilisateur
print-stats.job-count – le nombre total de travaux d'impression pour l'utilisateur
print-stats.page-count – le nombre total de pages imprimées pour l'utilisateur
taux d'ajustement des coûts d'impression pourcentage – pourcentage permettant d'ajuster le coût des travaux de l'utilisateur.
restreint – que l'utilisateur soit ou non actuellement restreint
secondary-card-number – numéro de la carte secondaire de l'utilisateur
non authentifié – que l'utilisateur soit ou non un utilisateur authentifié
nom d'utilisateur – alias – alias de l'utilisateur. Utilisé uniquement lorsque l'alias de nom d'utilisateur est activé.
set-user-property
Définit une propriété d'utilisateur.
– Le nom d'utilisateur.
– le nom de la propriété à définir. Les propriétés et valeurs valides incluent:
auto-release-jobs – Indique si les travaux de l'utilisateur seront toujours publiés lors de la connexion du périphérique (TRUE ou FALSE). Remarque: Si vous définissez cette propriété et que la case Remplacer les paramètres de l'imprimante / du périphérique de la page Détails de l'utilisateur n'est pas sélectionnée dans l'interface Web d'administration, tous les paramètres situés sous Remplacer les paramètres de l'imprimante / du périphérique seront supprimés et seul ce paramètre sera appliqué.
solde – solde du compte actuel de l'utilisateur (un nombre décimal)
card-pin – le numéro de la carte de l'utilisateur (n'importe quel texte)
default-shared-account – nom du compte partagé par défaut de l'utilisateur
department – le département de l'utilisateur (n'importe quel texte)
disabled-net – que l'accès Internet de l'utilisateur soit ou non actuellement désactivé (TRUE ou FALSE) (obsolète)
disabled-print – que l'impression de l'utilisateur soit actuellement désactivée (TRUE ou FALSE)
ne pas appliquer les règles de filtrage d’imprimante: s’il faut ou non appliquer les paramètres de filtre de l’imprimante aux travaux de l’utilisateur (TRUE ou FALSE). Remarque: Si vous définissez cette propriété et que la case Remplacer les paramètres de l'imprimante / du périphérique de la page Détails de l'utilisateur n'est pas sélectionnée dans l'interface Web d'administration, tous les paramètres situés sous Remplacer les paramètres de l'imprimante / du périphérique seront supprimés et seul ce paramètre sera appliqué.
ne pas archiver – si les travaux de l'utilisateur seront archivés (TRUE ou FALSE).Remarque: Si vous définissez cette propriété et que la case Remplacer les paramètres de l'imprimante / du périphérique de la page Détails de l'utilisateur n'est pas sélectionnée dans l'interface Web d'administration, tous les paramètres situés sous Remplacer les paramètres de l'imprimante / du périphérique seront supprimés et seul ce paramètre sera appliqué.
dont-hold-jobs-in-release-station – indique si le travail de l'utilisateur contourne ou non les files d'attente de publication (TRUE ou FALSE).Remarque: Si vous définissez cette propriété et que la case Remplacer les paramètres de l'imprimante / du périphérique de la page Détails de l'utilisateur n'est pas sélectionnée dans l'interface Web d'administration, tous les paramètres situés sous Remplacer les paramètres de l'imprimante / du périphérique seront supprimés et seul ce paramètre sera appliqué.
email – l'email de l'utilisateur (une adresse email, ou n'importe quel texte)
nom complet – le nom complet de l'utilisateur (n'importe quel texte)
home – le dossier de base de l'utilisateur (chemin UNC à double guillemet)
notes – notes pour l'utilisateur (n'importe quel texte)
office – le bureau de l'utilisateur (n'importe quel texte)
other-emails – les autres emails de l'utilisateur (une liste séparée par des virgules). Utilisez un blanc pour effacer tous les autres courriels
découvert – montant – pour les utilisateurs restreints avec un mode de découvert «INDIVIDUAL», la limite de découvert de l’utilisateur (un nombre décimal)
password – le mot de passe de l'utilisateur (pour les utilisateurs internes uniquement) (n'importe quel texte)
primary-card-number – le numéro de carte de l'utilisateur (n'importe quel texte)
taux d'ajustement des coûts d'impression pourcentage – pourcentage permettant d'ajuster le coût des travaux de l'utilisateur. Si égal ou supérieur à 0, définit le pourcentage sur . Si moins de 0 ou pas un nombre, affiche une erreur. Si est vide (""), désactivez le drapeau "Multiplier les coûts des travaux par". Remarque: Si vous définissez cette propriété et que la case Remplacer les paramètres de l'imprimante / du périphérique de la page Détails de l'utilisateur n'est pas sélectionnée dans l'interface Web d'administration, tous les paramètres situés sous Remplacer les paramètres de l'imprimante / du périphérique seront supprimés et seul ce paramètre sera appliqué.
restreint – que l'utilisateur soit actuellement restreint ou non (VRAI ou FAUX)
secondary-card-number – numéro de la carte secondaire de l'utilisateur (n'importe quel texte)
non authentifié – que l'utilisateur soit ou non un utilisateur authentifié (TRUE ou FALSE)
nom d'utilisateur-alias – alias de l'utilisateur. Utilisé uniquement lorsque l'alias de nom d'utilisateur est activé.
– la valeur à définir (voir pour les valeurs valides).
clear-user-advanced-settings-printer
Décochez la case Remplacer les paramètres de l'imprimante / du périphérique et tous les paramètres correspondants sous la page Détails de l'utilisateur.
Remarque: Ce comportement diffère de l'interface Web d'administration en ce sens que lorsque vous désactivez la case à cocher Remplacer les paramètres d'imprimante / de périphérique, tous ses paramètres sont conservés.
– Le nom d'utilisateur.
ajuster-utilisateur-compte-solde [[[[]
Ajustez le solde du compte d'un utilisateur.
– le nom d'utilisateur de l'utilisateur.
– le montant de l'ajustement sous forme de nombre. + ve ou -ve.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
ajuster-compte-utilisateur-solde-si-disponible
[[[[]
Ajustez le solde du compte d'un utilisateur si le crédit disponible est suffisant.
– le nom d'utilisateur de l'utilisateur.
– le montant de l'ajustement sous forme de nombre. + ve ou -ve.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
ajuster-compte-utilisateur-solde-si-disponible-laisser-restant
[[[[]
Ajuster le solde du compte d'un utilisateur s'il y a suffisamment de crédit disponible
laisser le montant donné disponible sur le compte.
– le nom d'utilisateur de l'utilisateur.
– le montant de l'ajustement sous forme de nombre. + ve ou -ve.
– le montant à laisser dans le compte.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
ajuster-compte-utilisateur-solde-par-groupe
[[[[]
Ajustez le solde du compte pour tous les utilisateurs d'un groupe. Ce processus se passe en arrière-plan.
– le groupe pour lequel tous les comptes d'utilisateurs doivent être ajustés.
– le montant de l'ajustement sous forme de nombre. + ve ou -ve.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
ajuster-compte-utilisateur-solde-par-groupe-jusqu'à-
[[[[]
Ajustez le solde du compte pour tous les utilisateurs d'un groupe, mais n'augmentez pas le solde de l'utilisateur au-delà de la limite donnée. Ce processus se passe en arrière-plan.
– le groupe pour lequel tous les comptes d'utilisateurs doivent être ajustés.
– le montant de l'ajustement sous forme de nombre. Doit être + ve.
– n'augmentez pas le solde utilisateur au-delà de cette limite.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
set-user-account-balance [[[[]
Définissez le solde du compte d'un utilisateur sur une valeur définie.
– le nom d'utilisateur de l'utilisateur.
– définir le compte à cette valeur. + ve ou -ve.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
set-user-account-balance-by-group [[[[]
Définissez la balance pour chaque membre d'un groupe à la valeur donnée. Ce processus se passe en arrière-plan.
– le groupe pour lequel le solde de tous les utilisateurs doit être défini.
– la valeur pour définir le solde de tous les utilisateurs sur. + ve ou -ve.
– un commentaire à associer à la transaction.
[[[[]- Nom de compte personnel facultatif. Utilisé uniquement lorsque plusieurs comptes personnels sont activés.
get-user-overdraft-mode
Obtenir le mode de découvert d'un utilisateur restreint.
– le nom d'utilisateur de l'utilisateur restreint.
– le mode découvert de l’utilisateur restreint. Les valeurs valides sont:
DEFAULT – utilisez la limite de découvert par défaut appliquée à tous les utilisateurs et comptes partagés.
INDIVIDUAL – utilisez une limite individuelle de découvert spécifique à l'utilisateur.
set-user-overdraft-mode
Définir le mode de découvert d'un utilisateur restreint.
– le nom d'utilisateur de l'utilisateur restreint.
– définir le mode de découvert de l’utilisateur. Les valeurs valides sont:
DEFAULT – utilisez la limite de découvert par défaut appliquée à tous les utilisateurs et comptes partagés.
INDIVIDUAL – utilisez une limite individuelle de découvert spécifique à l'utilisateur.
réinitialiser-compte-utilisateur
Réinitialisez le nombre de pages et de travaux associé à un utilisateur.
– le nom d'utilisateur de l'utilisateur.
– nom de l'utilisateur / script / processus réinitialisant les comptes.
re-apply-initial-user-settings
Réapplique les paramètres initiaux sur l'utilisateur. Les paramètres utilisateur initiaux sont basés sur l'appartenance à un groupe.
– le nom d'utilisateur de l'utilisateur.
désactiver l'impression pour l'utilisateur
Désactiver l'impression pour un utilisateur pour une période de temps définie.
– le nom de l'utilisateur pour lequel désactiver l'impression.
– le temps en minutes pour désactiver. -1 indique pour toujours.
ajouter un nouvel utilisateur
Déclenchez le processus d’ajout d’un nouveau compte utilisateur. En supposant que l'utilisateur existe dans le répertoire utilisateur du système d'exploitation / réseau / domaine, le compte est créé avec les paramètres initiaux corrects définis par les règles définies dans l'interface Web d'administration dans l'onglet Groupes.
– le nom d'utilisateur système de l'utilisateur.
renommer-utilisateur
Renommez l'utilisateur existant donné. Utilisez cette méthode avec soin. Renommer un utilisateur doit être effectué conjointement avec le renommage de l'utilisateur dans le système d'exploitation / réseau / domaine.
– le nom de l'utilisateur à renommer.
– le nouveau nom de l'utilisateur.
export-user-data-history
Pour vous conformer au droit d'accès au règlement général de l'UE sur la protection des données (RGPD), exportez les données utilisateur des rapports suivants dans cinq fichiers CSV:
Liste d'utilisateur
Impression utilisateur – journaux
Accès sécurisé au compte partagé
Impact environnemental de l'utilisateur – résumé
Journaux de transaction
Remarque: Les fichiers seront la propriété du compte système qui exécute le PaperCut NG / MF processus. Le dossier de sortie doit également disposer d'autorisations en écriture pour cet utilisateur.
Remarque: Les données personnelles de l'application Scan to Cloud doivent être demandées séparément en envoyant un courrier électronique à privacy@papercut.com.
– le nom d'utilisateur système de l'utilisateur.
– l'emplacement de stockage des cinq fichiers CSV. Il peut s'agir d'un chemin relatif ou absolu sous le répertoire de base de l'emplacement d'installation du serveur d'applications. par exemple. / server / tmp
supprimer-utilisateur-existant [[[[]
Supprimer un compte d'utilisateur du système. Utilisez-le avec précaution car il s'agit d'une opération à sens unique qui ne peut pas être annulée. Cet appel supprime définitivement le compte d'utilisateur de la liste des utilisateurs (les enregistrements d'historique d'impression restent conservés).
– le nom d'utilisateur système de l'utilisateur.
[[[[]- Les drapeaux disponibles incluent:
données de l'utilisateur de suppression permanente – supprime de façon permanente les informations d'utilisateur identifiables afin de se conformer au droit à l'oubli du règlement européen sur la protection des données (RGPD).
Le journal des applications de l'interface Web Admin affiche l'événement de rédaction associé à l'utilisateur.
Les données identifiant l'utilisateur (nom d'utilisateur, compte, nom du document, taille du document, ordinateur client, commentaires) sont affichées comme rédigées aux endroits suivants:
Détails de l'utilisateur dans l'interface Web de l'administrateur
Journaux de travail dans l'interface Web d'administration
Rapports
Les données d'identification de l'utilisateur ne sont plus affichées aux endroits suivants:
Impact sur l'environnement de l'utilisateur – Rapport de synthèse de l'utilisateur expurgé
En outre, tous les événements du journal d'audit associés à l'utilisateur sont supprimés.
Remarque: Cela ne supprime pas les adresses électroniques de l'utilisateur expurgé qui ne sont pas spécifiées dans les détails de l'utilisateur dans l'interface Web d'administration (par exemple, les adresses de numérisation vers une adresse électronique).
Remarque: La rédaction des données personnelles de l'application Scan to Cloud doit être demandée séparément en envoyant un courrier électronique à privacy@papercut.com.
add-new-internal-user
Créez un nouvel utilisateur interne. Nom d'utilisateur et mot de passe sont requis. Vous pouvez omettre d'autres propriétés. Les propriétés peuvent être modifiées après la création à l'aide de 'set-user-property'. Pour plus d'informations sur les utilisateurs internes, reportez-vous à la section «Utilisateurs internes» du manuel d'utilisation.
– (obligatoire) le nom d'utilisateur du nouvel utilisateur interne.
– mot de passe (obligatoire) de l'utilisateur.
– Nom complet de l'utilisateur (facultatif).
– adresse électronique de l'utilisateur (facultatif).
– la carte ou le numéro d'identité de l'utilisateur.
– le code PIN de la carte d'identité / de l'utilisateur.
recherche-nom-utilisateur-par-id-no
Recherche l'utilisateur avec le numéro d'identification donné et imprime son nom d'utilisateur. Si aucune correspondance n'a été trouvée, une ligne vide est imprimée.
– Le numéro d'identification de l'utilisateur à rechercher.
recherche-nom-utilisateur-par-carte-no
Cherche l'utilisateur avec le numéro de carte donné et imprime son nom d'utilisateur. Si aucune correspondance n'a été trouvée, une ligne vide est imprimée.
– Le numéro de la carte d'utilisateur à rechercher.
ajouter un utilisateur à un groupe
Ajouter un utilisateur au groupe spécifié. Cela change l'appartenance au groupe dans l'application, pas dans l'annuaire des utilisateurs du système d'exploitation / réseau / domaine.
– Le nom d'utilisateur.
– le nom du groupe auquel l'utilisateur doit être ajouté.
enlever-utilisateur-de-groupe
Supprimer un utilisateur du groupe spécifié. Cela change l'appartenance au groupe dans l'application, pas dans l'annuaire des utilisateurs du système d'exploitation / réseau / domaine.
– Le nom d'utilisateur.
– le nom du groupe duquel l'utilisateur doit être supprimé.
add-admin-access-user
Ajouter un utilisateur en tant qu'administrateur avec les droits d'administrateur par défaut.
– Le nom d'utilisateur.
remove-admin-access-user
Supprimer un utilisateur administrateur de la liste des administrateurs.
– Le nom d'utilisateur.
add-admin-access-group
Ajouter un groupe en tant que groupe d'administrateur avec des droits d'administrateur par défaut.
– le nom du groupe.
remove-admin-access-group
Supprimer un groupe de la liste des groupes d'administrateurs.
– le nom du groupe.
set-user-account-selection-auto-select-shared-account
Définit la sélection du compte d'un utilisateur pour facturer à un seul compte partagé.
– Le nom d'utilisateur.
– Nom complet du compte partagé auquel facturer.
– si le compte personnel de l'utilisateur sera débité ou non. (Vrai ou faux)
set-user-account-selection-auto-charge-personal [[[[]
Définit la sélection du compte d'un utilisateur pour qu'elle se charge automatiquement sur son compte personnel.
– Le nom d'utilisateur.
[[[[]- (facultatif) si une fenêtre contextuelle de confirmation est affichée ou non. (Vrai ou faux). FALSE par défaut.
set-user-account-selection-standard-popup
[[[[]
Définit la sélection du compte d'un utilisateur sur.
– Le nom d'utilisateur.
– permettre à l'utilisateur de facturer à compte personnel.
– permettre à l'utilisateur de sélectionner un compte partagé dans la liste. (Vrai ou faux) – permettre à l'utilisateur de sélectionner un compte partagé à l'aide de l'épingle.
– permettre à l'utilisateur d'imprimer en tant qu'autre utilisateur.
– lorsque le compte partagé est sélectionné, imputer à un compte personnel. (Vrai ou faux)
[[[[]- Compte partagé par défaut facultatif
liste-utilisateur-comptes
Répertoriez les noms de tous les comptes d'utilisateurs du système, triés par nom d'utilisateur, un par ligne.
get-total-users
Obtient un nombre de tous les utilisateurs du système.
liste-comptes-partagés
Répertorie les noms de tous les comptes partagés dans le système, triés par nom de compte partagé, un par ligne.
liste-utilisateur-comptes-partagés [[[[]
Répertorie les noms de tous les comptes partagés accessibles par l'utilisateur donné, triés par nom de compte, un par ligne.
– Utilisateur pour lequel lister les comptes
[[[[]- Optionnel. Spécifiez TRUE pour ignorer le mode de sélection du compte de l'utilisateur. (Vrai ou faux)
compte-partagé-existe
Testez pour voir si un compte partagé existe.
– le nom du compte partagé à tester.
obtenir-solde-compte-partagé
Obtenez le solde actuel du compte partagé.
– le nom complet du compte partagé.
get-shared-account-overdraft-mode
Obtenir le mode de découvert d'un compte partagé restreint.
– le nom complet du compte partagé restreint.
– le mode de découvert du compte partagé restreint. Les valeurs valides sont:
DEFAULT – limite de découvert par défaut appliquée à tous les utilisateurs restreints et comptes partagés.
INDIVIDUAL – limite individuelle de découvert spécifique au compte partagé restreint.
get-shared-account-property
Obtient une propriété de compte partagé.
– le nom du compte partagé.
– le nom de la propriété à obtenir. Les propriétés valides incluent:
access-groups – les groupes d'accès du compte partagé (une liste séparée par des virgules). Utilisez des blancs pour effacer tous les groupes
access-users – les utilisateurs d'accès au compte partagé (une liste séparée par des virgules). Utilisez un blanc pour effacer tous les utilisateurs
solde – solde actuel du compte partagé
comment-option – l'option de commentaire du compte partagé
disabled – que le compte partagé soit actuellement désactivé ou non
facture-option – option de facturation du compte partagé
notes – notes pour le compte partagé
découvert-montant – pour les comptes restreints avec un mode de découvert «INDIVIDUEL», la limite de découvert du compte partagé
pin – le code PIN du compte partagé
restreint – que le compte partagé soit actuellement restreint ou non
set-shared-account-property
Définit une propriété de compte partagé.
– le nom du compte partagé.
– le nom de la propriété à définir. Les propriétés et valeurs valides incluent:
access-groups – les groupes d'accès du compte partagé) (une liste séparée par des virgules)
access-users – les utilisateurs d'accès au compte partagé (une liste séparée par des virgules)
solde – solde actuel du compte partagé (un nombre décimal)
comment-option – l'option de commentaire du compte partagé. Un des:
NO_COMMENT – aucun commentaire ne peut être saisi
COMMENT_REQUIRED – un commentaire doit être saisi
COMMENT_OPTIONAL – l'utilisateur peut entrer un commentaire ou non
disabled – que le compte partagé soit actuellement désactivé (TRUE ou FALSE)
facture-option – option de facturation du compte partagé. Un des:
ALWAYS_INVOICE – les travaux d'impression sont facturés
NEVER_INVOICE – les travaux d'impression ne sont jamais facturés
USER_CHOICE_ON – l'utilisateur peut choisir (valeur par défaut / oui)
USER_CHOICE_OFF – l'utilisateur peut choisir (désactivé / non)
notes – notes pour le compte partagé (n'importe quel texte)
découvert – montant – pour les comptes restreints avec un mode de découvert «Individuel», limite de découvert du compte partagé (un nombre décimal)
pin – le code PIN du compte partagé (n'importe quel texte, il doit être unique)
restreint – que le compte partagé soit ou non actuellement
restreint (VRAI ou FAUX)
– la valeur à définir (voir pour les valeurs valides).
ajuster-compte-partagé-solde-compte
Ajustez le solde d'un compte partagé.
– le nom complet du compte partagé.
– le montant de l'ajustement sous forme de nombre. + ve ou -ve.
– un commentaire à associer à la transaction.
set-shared-account-account-solde
Définissez le solde d'un compte partagé sur une valeur définie.
– le nom complet du compte partagé.
– définir le compte à cette valeur. + ve ou -ve.
– un commentaire à associer à la transaction.
set-shared-account-overdraft-mode
Définir le mode de découvert d'un compte partagé restreint.
– le nom complet du compte partagé restreint.
– définir le mode de découvert du compte partagé restreint. Les valeurs valides sont:
DEFAULT – limite de découvert par défaut appliquée à tous les utilisateurs restreints et comptes partagés.
INDIVIDUAL – limite individuelle de découvert spécifique au compte partagé restreint.
ajouter-nouveau-compte-partagé
Ajouter un nouveau compte partagé.
– le nom du compte partagé.
renommer-compte-partagé
Renommez un compte partagé existant.
– Nom du compte partagé actuel. Utilisez un '' pour désigner un sous-compte, par exemple: 'parent sub'
– Nouveau nom de compte partagé.
supprimer-existant-compte-partagé
Supprimer un compte partagé du système. Utilisez cette méthode avec soin. Cet appel le supprime définitivement de la liste des comptes partagés (les enregistrements d'historique d'impression restent conservés).
– le nom du compte partagé à supprimer.
add-shared-account-access-user
Autoriser l'utilisateur donné à accéder au compte partagé donné sans utiliser d'épingle.
– le nom du compte partagé auquel permettre l'accès.
– le nom de l'utilisateur auquel donner accès.
add-shared-account-access-group
Autoriser le groupe donné à accéder au compte partagé donné sans utiliser d'épingle.
– le nom du compte partagé auquel permettre l'accès.
– le nom du groupe auquel donner accès.
remove-shared-account-access-user
Révoquer l'accès utilisateur donné au compte partagé donné.
– le nom du compte partagé auquel révoquer l'accès. – le nom de l'utilisateur pour qui révoquer l'accès.
remove-shared-account-group-access
Révoquez l'accès du groupe donné au compte partagé donné.
– le nom du compte partagé auquel révoquer l'accès.
– le nom du groupe pour lequel révoquer l'accès.
get-printer-property
Obtient une propriété d'imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– le nom de la propriété à obtenir. Pour obtenir une liste des propriétés valides, reportez-vous à la section Définition des propriétés avancées de l'imprimante.
set-printer-property
Définit une propriété d'imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– le nom de la propriété à définir. Pour obtenir une liste des propriétés valides, reportez-vous à la section Définition des propriétés avancées de l'imprimante.
– la valeur à définir.
imprimeurs de liste
Répertoriez les noms de toutes les imprimantes du système, triés par nom d’imprimante, un par ligne.
générer-imprimante-qr-codes
Génère un code QR pour chaque imprimante et les enregistre dans
.
Ces codes QR peuvent être utilisés à partir de l'application pour libérer un travail sans avoir besoin de se connecter à un périphérique.
– Indique si les URL codées doivent utiliser HTTP ou HTTPS (TRUE ou FALSE)
– adresse IP publique ou nom d'hôte du serveur d'applications PaperCut MF / NG
– Numéro de port utilisé par le serveur d'applications PaperCut MF / NG, généralement 9191 (HTTP) ou 9192 (HTTPS).
– Le chemin absolu ou relatif du répertoire d'installation de NG / MF vers le dossier dans lequel les codes QR générés sont enregistrés.
set-printer-cost-simple
Définit le coût de la page de l’imprimante (en utilisant le modèle de charge SIMPLE).
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– le coût par page (modèle de charge simple)
get-printer-cost-simple
Obtenez le coût de la page de l'imprimante (en utilisant le modèle de charge SIMPLE).
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
réinitialiser-compte-imprimante
Réinitialisez le nombre de pages et de travaux associé à une imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– nom de l'utilisateur / script / processus réinitialisant les comptes.
groupe-imprimante-addition
Ajoutez une imprimante à une imprimante en plus de l'appartenance à un groupe d'imprimantes existant.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– nom d'un groupe d'imprimantes.
set-printer-groups
Définissez les groupes d'imprimantes auxquels une imprimante appartient, en écrasant toute appartenance à un groupe existant.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– une liste de noms de groupes d'imprimantes, séparés par des virgules. Pour effacer toutes les associations de groupe réglées sur "".
activer-imprimante
Activer une imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
désactiver-imprimante
Désactiver une imprimante pour une période de temps définie.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante.
– le temps en minutes pour désactiver. -1 indique pour toujours.
supprimer-imprimante
Supprimer une imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de l'imprimante. Utilisation "[All Printers]"pour supprimer toutes les imprimantes du serveur spécifié.
renommer-imprimante
Renommez une imprimante. Ceci est utile après la migration d'un ou (c'est-à-dire que l'imprimante conserve son historique et ses paramètres sous le nouveau nom). Notez que, dans certains cas, la sensibilité à la casse est importante. Veillez donc à saisir le nom exactement tel qu'il est affiché dans le système d'exploitation.
– le nom du serveur existant, comme indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de la file d'attente de l'imprimante existante.
– le nom du serveur de la nouvelle imprimante.
– le nom de la file d'attente de la nouvelle imprimante.
add-printer-access-group
Ajoute le groupe d'utilisateurs à la liste des groupes d'accès de l'imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de la file d'attente de l'imprimante.
– le nom du groupe d'utilisateurs à ajouter.
enlever-imprimante-groupe d'accès
Supprime le groupe d'utilisateurs de la liste des groupes d'accès de l'imprimante.
– le nom du serveur, tel qu'il est indiqué sur la page Imprimantes de l'interface d'administration.
– le nom de la file d'attente de l'imprimante.
– le nom du groupe d'utilisateurs à supprimer.
ajouter-nouveau-groupe
Ajoutez un nouveau groupe à la liste de groupes du système. Le groupe devrait déjà exister dans le répertoire réseau.
– Le nom du groupe à ajouter.
groupe de synchronisation
Synchronise un groupe existant avec le serveur d'annuaire configuré, met à jour l'appartenance au groupe dans le système.
– Le nom du groupe à synchroniser.
groupe de suppression
Supprime le groupe.
– Le nom du groupe à supprimer.
obtenir des groupes d'utilisateurs
Récupère tous les groupes auxquels un seul utilisateur appartient.
– Le nom de l'utilisateur à interroger.
groupes d'utilisateurs
Répertorie les noms de tous les groupes d'utilisateurs du système, triés par nom de groupe, un par ligne.
groupe-existe
Testez pour voir si un groupe existe.
– le nom du groupe à tester.
set-group-quota
– le nom du groupe à définir.
– le montant du quota.
– la période prévue (c’est-à-dire QUOTIDIEN, HEBDOMADAIRE, MENSUEL).
– le montant maximum d'accumulation du quota. Définir à 0.0 pour ne pas avoir de limite.
get-group-quota
Obtenir les paramètres d'allocation de quota de groupe sur un groupe donné.
Renvoie le montant du quota, la période de planification et le montant d'accumulation maximum du quota.
– le nom du groupe à obtenir.
carte-usage
Échangez une carte et placez le crédit sur le compte de l'utilisateur.
– le nom de l'utilisateur avec le compte à créditer.
– le numéro de la carte à utiliser.
effectuer une sauvegarde en ligne
Lancer une sauvegarde en ligne. Le fichier de retour est écrit dans ~ / server / data / backups. sous forme de fichier XML zippé daté. Ce processus se passe en arrière-plan.
effectuer-sync-groupe
Démarrez le processus de synchronisation de l'appartenance au groupe du système avec l'appartenance au groupe du système d'exploitation / réseau / domaine. Un appel à cette méthode démarre le processus de synchronisation et l'opération se termine en arrière-plan.
effectuer la synchronisation des utilisateurs et des groupes
Démarrer une synchronisation complète des utilisateurs et des groupes. Cela équivaut à cliquer sur "Synchroniser maintenant" dans l'interface Web de l'administrateur. Aucun utilisateur existant n'est supprimé. La mise à jour complète ou non des informations relatives aux utilisateurs existants dépend des paramètres de synchronisation utilisateur / groupe actuels définis dans l'interface Web d'administration. Un appel à cette méthode démarre le processus de synchronisation et l'opération se termine en arrière-plan.
effectuer-avancé-utilisateur-et-groupe-synchronisation
Une version avancée du processus de synchronisation des utilisateurs et des groupes permettant de contrôler les paramètres de synchronisation. Un appel à cette méthode démarre le processus de synchronisation et l'opération se termine en arrière-plan.
– mettre à TRUE supprimer les anciens utilisateurs, sinon FALSE.
– définissez sur VRAI si les détails des utilisateurs existants (par exemple, courrier électronique, nom complet, etc.) doivent être mis à jour.
ajouter-nouveaux-utilisateurs
L'appel de cette méthode démarre un processus spécialisé de synchronisation d'utilisateurs et de groupes optimisé pour le suivi de l'ajout de nouveaux utilisateurs existant dans le répertoire utilisateur du système d'exploitation / réseau / domaine et non dans le système. Tous les comptes d'utilisateurs existants ne sont pas modifiés. Une synchronisation de groupe est effectuée uniquement si de nouveaux utilisateurs sont réellement ajoutés au système.
est-tâche-complète
Renvoie VRAI si une tâche de longue durée, telle que perform-group-sync, perform-user-and-sync-group, ou add-new-users, est terminée.
get-task-status
Renvoie des informations sur l'état, telles que la progression, l'état d'achèvement et les messages d'erreur, lors de la dernière tâche en cours ou de la dernière exécution longue, telles que la synchronisation perform-group-, la synchronisation perform-user-and-group-sync ou add-new-users.
batch-import-shared-accounts
Importez les comptes partagés contenus dans le fichier d'importation délimité par des tabulations donné. Par exemple, server-command.exe batch-import-shared-accounts "c: programmes PaperCut MF folder papercut.txt" FALSE TRUE
– l'emplacement du fichier d'importation.
– (VRAI ou FAUX) Si VRAI, effectuez un test uniquement. Les statistiques imprimées montrent ce qui se serait passé si les tests n'avaient pas été activés. Aucun compte n'est modifié.
– (VRAI ou FAUX) Si VRAI, les comptes qui n'existent pas dans le fichier d'importation mais qui existent dans le système sont supprimés. Si FALSE, ils sont ignorés.
batch-import-users
Importez les utilisateurs contenus dans le fichier d'importation délimité par des tabulations donné. Reportez-vous à la section "Importation et mise à jour par lots de données utilisateur par lots" du manuel d'utilisation pour obtenir une description du format de fichier.
– l'emplacement du fichier d'importation.
Si TRUE, seuls les utilisateurs existants dans le fichier d'importation sont créés, sinon ignorés.
batch-import-internal-users
Importez les utilisateurs internes contenus dans le fichier d'importation délimité par des tabulations donné. Reportez-vous à la section "Format de fichier d'importation utilisateur interne par lots" du manuel de l'utilisateur pour obtenir une description du format de fichier.
– l'emplacement du fichier d'importation.
(optional, default TRUE) – (TRUE or FALSE) If TRUE, passwords from the import file overwrite existing passwords where a user already has a has a password set. If FALSE, existing passwords are not changed.
(optional, default TRUE) – (TRUE or FALSE). If TRUE, PINs from the import file overwrite existing PINs where a user already has a has a PIN set. If FALSE, existing PINs are not changed.
batch-import-user-card-id-numbers
Import the user card/ID numbers and PINs contained in the given tab-delimited import file. See the user manual section 'Advanced User Management' for a description of the file format).
– the import file location.
(optional, default TRUE) – (TRUE or FALSE). If TRUE, PINs from the import file overwrites existing PINs where a user already has a has a PIN set. If FALSE, existing PINs are not changed.
create-user-client-accounts-file
Saves a file containing shared accounts data for the . See the manual for more information on how you can use this feature. The file is saved on the server to the location:
[app-path]serverdataclientclient-accounts.dat
If this file already exists it is over-written.
get-config
Gets the value of the given config value printing the result. If the config value does not exist, a blank string is displayed.
– the name of the config value to get.
set-config
Sets the value of the give config item.
NOTE: Take care updating config values. You might cause serious problems that can be fixed only by reinstallation of the application. Use the set-config command at your own risk.
– the name of the config value to set.
– the value to set.
process-job
Takes the details of a job and logs and charges as if it were a "real" job. Jobs processed via this method are not susceptible to , popups, hold/release queues etc., they are logged. See the user manual section "Importing Job Details" for more information and the format of .
– the details of the job to log.
run-command command-name [command args]
Runs a custom command on the server. By default the server does not include any custom commands. The command arguments depend on the custom command being run.
<div class="TipDiv" data-mc-autonum="Pointe: ">Pointe:
- server-command is ideal for scripting via batch files or shell scripts. You can find some example scripts at [app-path]/server/examples/scripting/. Administrators wanting to control PaperCut NG / MF using a programming language such as C#, Java, Visual Basic, Perl, Ruby or Python should consider the XML Web Services APIs. All commands available via the server-command tool are also accessible via calls to the Web Services layer. More information on the XML Web Services is available in The XML Web Services API.
- Checking for errors: generally
server-command returns an exit value of 0. When writing your script you should check the string value that server-command prints on standard output instead. server-command return a non-zero return value if it detects an error with the parameters passed on the command line.
- Some commands (e.g.
batch-import-internal-users) expect values that are vrai ou faux. In this case the command parameter is compared to the value vrai using a case insensitive compare, all other values are assumed to be faux.
- If you need to use PaperCut NG / MF's built-in group's name (i.e. "All users" group) in a server command, then use the group name exactly as it is displayed in the Admin web interface. (par exemple.
remove-user-from-group guest-user "[Internal Users]")
Commentaires
Laisser un commentaire