La liste suivante décrit les commandes de base de la CLI.
Description
La commande alias permet de créer un alias pour les commandes fréquemment utilisées ou celles qui sont associées à des paramètres compliqués. Un alias ne peut pas être identique au nom d'une commande de la CLI existante. Si une définition contient des blancs, ils doivent être mis entre guillemets anglo-saxons doubles (", caractère ASCII 0x22).
Quand l'utilisateur ferme une session de CLI, les alias qu'il a créés sont stockés dans un fichier qui se trouve dans le répertoire aliases. Ces alias seront ainsi de nouveau disponibles lors de la session de CLI suivante ouverte par l'utilisateur.
Syntaxe
alias [<pseudonyme>="commande [paramètres]"]
Exemples
> alias assign=set > alias alarmes="getAlarms severity=dwn" |
Si elle est appelée sans argument, la commande alias imprime la liste des alias définis et leur valeur respective. L'exemple suivant montre le résultat de la commande alias quand cette commande est appelée sans argument.
> alias assign - set alarmes - getAlarms severity=dwn |
La commande attrib extrait les attributs d'un objet topologique.
Syntaxe
attrib [groupe=nomGroupe [nom=nomAttribut] [-key]]
La commande browse active le mode d'exploration de la topologie.
Syntaxe
browse
Description
La commande cd permet de changer le chemin topologique courant. Si aucun chemin n'est spécifié, le chemin courant est défini comme domaine par défaut. Si un nombre (n) est spécifié, le chemin courant est défini comme étant le nième chemin enfant, comme indiqué par la commande list.
Syntaxe
cd [chemin|nombre]
Description
La commande clear supprime tous les paramètres définis au cours de la session courante. Cependant, cette commande ne supprime pas les paramètres définis à partir de la ligne de commande. Elle est similaire à la commande unset, mais ne requiert pas la spécification de noms de paramètres en tant qu'arguments.
Syntaxe
clear
La commande data affiche les informations détaillées relatives à un objet topologique. Si un nombre est spécifié (n), le chemin est défini comme étant le nième chemin enfant, comme indiqué par la commande list.
Syntaxe
data [chemin|nombre|-key]
La commande end désactive le mode d'exploration de la topologie.
Syntaxe
end
Description
La commande exit met fin à la connexion avec le serveur et ferme la session de CLI.
Syntaxe
exit [-onError]
Paramètre
onError
Le paramètre onError est utilisé pour mettre fin à la session de CLI si une exception survient pendant l'exécution de la commande précédente. Ce paramètre est uniquement utilisé en mode différé.
La commande exit et la commande quit sont identiques.
La commande goto lance une recherche sensible à la casse d'un chemin topologique correspondant au modèle et l'active. Si plusieurs chemins correspondent au modèle, l'utilisateur est invité à choisir celui à utiliser.
Syntaxe
goto <modèle>
Description
La commande help affiche des informations sur les commandes de la CLI et leurs paramètres. Les informations d'aide sont formatées pour être affichées sur un écran de terminal non-bitmap. Lorsque la commande help est exécutée sans argument, l'aide affiche une liste classée par ordre alphabétique et une brève description des commandes de CLI disponibles. Les commandes de base sont listées en premier suivies des commandes étendues. Lorsque la commande help est appelée avec le nom d'une commande de CLI comme argument, help affiche les informations spécifiques à cette commande. Appelée avec le paramètre about, la commande help affiche la version de Sun Management Center.
Syntaxe
help [<commande>|about]
Paramètres
commande et about.
Exemple
L'exemple suivant affiche l'aide pour la commande getAlarms.
> help getAlarms getAlarms [a=hôte[,hôte]+] [liste_filtre_alarmes] - Affiche les informations sur les alarmes d'un agent ou une listes d'agents en fonction d'un ensemble de conditions de filtrage. Si aucun agent n'est fourni, toutes les alarmes sont affichées. Toutes les conditions de filtrage sont liées par un "ET" logique pour l'obtention du résultat. Les conditions de filtrage spécifiées dans liste_filtre_alarmes peuvent être les : domain=domaine et/ou m=module[+instance] et/ou managed_object=obet_géré et/ou property=propriété et/ou property_instance=instance_propriété et/ou qualifier=qualificateur et/ou severity=[DIS,DWN,ERR,OFF,INF,IRR,WRN] et/ou state=[C,F,O] et/ou ack=[A,N] |
Description
La commande history répertorie ou exécute les commandes précédemment entrées au cours de la session de CLI. Si elle est appelée sans argument alors qu'un historique a précédemment été défini, toutes les commandes entrées plus tôt au cours de la session de CLI sont affichées. Si elle appelée avec un argument numérique alors qu'un historique a été précédemment défini, la commande correspondant à l'argument spécifié est exécutée.
Syntaxe
history [num]
Description
La commande kill met fin à toute commande en cours d'exécution en arrière-plan.
Syntaxe
kill
Description
La commande list affiche la liste des objets pour un chemin donné. Si un nombre (n) est spécifié, le chemin est défini comme étant le nième chemin enfant, comme indiqué par cette commande.
Syntaxe
list [chemin|nombre]
Description
La commande locate permet de rechercher tous les chemins topologiques correspondant au modèle spécifié. Le modèle est sensible à la casse.
Syntaxe
locate <modèle>
Description
La commande login établit une connexion avec un serveur Sun Management Center. Vous pouvez spécifier le paramètre serverHost et, en option, le paramètre serverPort comme arguments. Si aucun hôte n'est spécifié, vous êtes invité à en entrer un. Si aucun port n'est spécifié, le port 2099 est utilisé. La commande login vous demande également votre nom d'utilisateur et votre mot de passe.
Syntaxe
login [serverHost=hôte] [serverPort=numéroPort] [user=nomUtilisateur] [password=motDePasseUtilisateur]
Paramètres
serverHost, serverPort, user et password
Description
La commande logout met fin à votre connexion au serveur Sun Management Center, mais pas à votre session de CLI.
Syntaxe
logout
Description
La commande print dirige la sorite de la dernière commande étendue dans le format spécifié et sur la destination indiquée. Par défaut, print dirige cette sortie sur l'écran du terminal en texte clair. Si les paramètres append ou o sont définis, la sortie est dirigée sur le fichier spécifié par ces paramètres. La sortie n'apparaît pas à l'écran. Si le paramètre ncols n'est pas spécifié, le nombre de colonnes par défaut est fixé à 4.
La commande print n'est pas enregistrée dans l'historique des commandes.
Syntaxe
print [f=plain|xml|html] [style=table|list|<custom>] [columns= columnList] [ncols=num] [o=outputFile | append=appendFile]
Paramètres
f, style, columns, ncols, o et append
Description
La commande quit met fin à la connexion avec le serveur et ferme la session de CLI.
Il n'y a pas de différence entre les commandes quit et exit.
Syntaxe
quit
Description
La commande reset ramène les valeurs de tous les paramètres qui sont spécifiés sur la ligne de commande aux valeurs qui avaient été spécifiées au début de la session de CLI. Les paramètres qui ont été définis pendant la session mais pas sur la ligne de commande restent inchangés. Si le nom d'un paramètre spécifique est fourni en tant qu'argument à reset et que la valeur de ce paramètre avait été spécifiée sur la ligne de commande, la valeur de ce paramètre est ramenée à sa valeur d'origine. Sinon, la valeur de ce paramètre reste inchangée.
La commande reset n'est pas enregistrée dans l'historique des commande.
Syntaxe
reset [<paramètre>]*
Description
La commande set vous permet de spécifier ou d'afficher des valeurs de paramètres. Les paramètres dont les valeurs sont spécifiées avec la commande set sont des paramètres globaux de la session courante. Les commandes globales sont disponibles pour toutes les commandes pendant cette session. Si vous exécutez set sans argument, la valeur de tous les paramètres définis pendant la session courante s'affiche. Si vous exécutez set avec un paramètre spécifié sous la forme d'un argument, la valeur de ce paramètre s'affiche.
Syntaxe
set [<paramètre>[=valeur]]* [height=num] [history=num] [log=fichier] [logmode=detailed|commande|"from n"] [more=on|off] [prompt=invite]
Exemple
L'exemple suivant montre les trois variantes de cette commande.
> set height=10 > set height=10 > set height height=10 |
Description
La commande status affiche l'état de toute commande en cours d'exécution en arrière-plan.
Syntaxe
status
Description
La commande unalias supprime l'alias ou la liste d'alias qui avait été spécifiée en tant qu'argument.
Syntaxe
unalias [<pseudonyme>]*
Description
La commande unset supprime le(s) paramètre(s) spécifié(s) de la session courante.
Syntaxe
unset [<paramètre>]*
La commande unset n'est pas enregistrée dans l'historique des commandes.
Description
La commande where affiche le chemin topologique courant.
Syntaxe
where