Groupe de commandes PolicySetManagement de l'objet AdminTask

Les langages de script Jython ou Jacl permettent de gérer les configurations d'ensemble de règles à l'aide de l'outil wsadmin. Les commandes et paramètres du groupe PolicySetManagement permettent de créer, de supprimer et de gérer des configurations de règle, d'ensemble de règles et d'association d'ensemble de règles.

Avant d'utiliser les commandes décrites dans cette rubrique, assurez-vous d'utiliser la version la plus récente de l'outil wsadmin. Les commandes de gestion de l'ensemble de règles admettant l'objet properties comme valeur pour les paramètres attributes ou bindingLocation ne sont pas prises en charge dans les versions précédentes. Par exemple, elles ne fonctionnent pas sur un noeud dont la version est 6.1.0.x.

Utilisez les commandes suivantes pour gérer les configurations d'ensemble de règles :
Utilisez les commandes suivantes pour gérer les paramètres de règle :
Utilisez les commandes suivantes pour gérer les liaisons d'ensemble de règles :

listPolicySets

La commande listPolicySets renvoie la liste de tous les ensembles de règles existants. Si la sécurité administrative est activée, chaque rôle utilisateur peut utiliser cette commande.

Objet cible

Aucun.

Paramètres optionnels

-policySetType
Indique le type de l'ensemble de règles. Spécifiez application pour afficher les ensembles de règles de l'application. Spécifiez system pour afficher les ensembles de règles système pour les associations de service d'accréditation ou WS-MetadataExchange. Spécifiez system/trust pour afficher les ensembles de règles du service d'accréditation. Spécifiez default pour afficher les ensembles de règles par défaut. La valeur par défaut de ce paramètre est application. (Chaîne, optionnelle)
-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie la liste de tous les ensembles de règles existants. Chaque entrée de la liste correspond au nom d'un ensemble de règles.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.listPolicySets('[-policySetType system/trust]')
  • A l'aide de la liste Jython :
    AdminTask.listPolicySets(['-policySetType', 'system/trust'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.listPolicySets('-interactive')

getPolicySet

La commande getPolicySet renvoie les attributs généraux, tels que la description et l'indicateur par défaut, pour l'ensemble de règles spécifié. Si la sécurité administrative est activée, chaque rôle utilisateur peut utiliser cette commande.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom d'ensemble de règles. Pour afficher la liste de tous les noms d'ensemble de règles, utilisez la commande listPolicySets. (Chaîne, obligatoire)

Paramètres optionnels

-isDefaultPolicySet
Indique si un ensemble de règles par défaut doit être affiché. La valeur par défaut est false. (Booléen, facultatif)
-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie la liste des attributs correspondant au nom d'ensemble de règles spécifié.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getPolicySet('[-policySet SecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.getPolicySet(['-policySet', 'SecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getPolicySet('-interactive')

createPolicySet

La commande createPolicySet crée un nouvel ensemble de règles. Les règles ne sont pas créées avec l'ensemble de règles. L'indicateur par défaut a pour valeur false.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour créer des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles. (Chaîne, obligatoire)

Paramètres optionnels

-description
Ajoute une description pour l'ensemble de règles. (Chaîne, obligatoire)
-policySetType
Indique le type de l'ensemble de règles. Lorsque la valeur est application, la commande crée des ensembles de règles d'application. Si la valeur est system, la commande crée un ensemble de règles que vous pouvez utiliser pour les associations du service d'accréditation ou WS-MetadataExchange. Lorsque la valeur est system/trust, la commande crée un ensemble de règles pour le service d'accréditation. La valeur par défaut de ce paramètre est application. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.createPolicySet('[-policySet myCustomPS -description [my new custom policy 
     set] -policySetType system/trust]')
  • A l'aide de la liste Jython :
    AdminTask.createPolicySet(['-policySet', 'myCustomPS', '-description',  '[my new custom 
     policy set]', '-policySetType', 'system/trust'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.createPolicySet('-interactive')

copyPolicySet

La commande copyPolicySet crée une copie d'un ensemble de règles existant. Par défaut, les associations d'ensemble de règles sont transférées au nouvel ensemble de règles.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour copier des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-sourcePolicySet
Indique le nom de l'ensemble de règles existant à copier. (Chaîne, obligatoire)
-newPolicySet
Indique le nom du nouvel ensemble de règles à créer. (Chaîne, obligatoire)
-newDescription
Spécifie une description pour le nouvel ensemble de règles. (Chaîne, obligatoire)

Paramètres optionnels

-transferAttachments
Si ce paramètre a pour valeur true, toutes les associations sont transférées de l'ensemble de règles source vers le nouvel ensemble de règles. La valeur par défaut est false. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.copyPolicySet('[-sourcePolicySet SecureConversation -newPolicySet  
     CustomSecureConversation -newDescription [mon nouvel ensemble de règles copié] -transferAttachments true]')
  • A l'aide de la liste Jython :
    AdminTask.copyPolicySet(['-sourcePolicySet', 'SecureConversation', '-newPolicySet',  
     'CustomSecureConversation', '-newDescription', '[my new copied policy set]',  '-transferAttachments', 
     'true'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.copyPolicySet('-interactive')

deletePolicySet

La commande deletePolicySet supprime l'ensemble de règles spécifié. Si des associations existent pour l'ensemble de règles, la commande renvoie un message d'échec.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour supprimer des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles à supprimer. (Chaîne, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.deletePolicySet('[-policySet customSecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.deletePolicySet(['-policySet', 'customSecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.deletePolicySet('-interactive')

updatePolicySet

La commande updatePolicySet permet d'entrer une liste d'attributs pour mettre à jour l'ensemble de règles. Vous pouvez utiliser cette commande pour mettre à jour tous les attributs de l'ensemble de règles ou un sous-ensemble d'attributs.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour mettre à jour la configuration des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles à mettre à jour. (Chaîne, obligatoire)
-attributes
Indique un objet propriétés contenant les attributs à mettre à jour pour l'ensemble de règles spécifié. (Propriétés, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.updatePolicySet('-policySet policySet1 -attributes [[type application] 
     [description [my policy set description]]]')
  • A l'aide de la liste Jython :
    AdminTask.updatePolicySet(['-policySet', 'policySet1', '-attributes', '[[type 
     application] [description [my policy set description]]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.updatePolicySet('-interactive')

addPolicyType

La commande addPolicyType ajoute une règle comportant des valeurs par défaut pour l'ensemble de règles spécifié. Vous devez indiquer si la règle ajoutée doit être activée ou désactivée.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour ajouter des règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles à mettre à jour. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle à ajouter dans l'ensemble de règles. (Chaîne, obligatoire)
-enabled
Si ce paramètre a pour valeur true, la nouvelle règle est activée dans l'ensemble de règles. Si ce paramètre a pour valeur false, la configuration est contenue dans l'ensemble de règles mais n'a pas d'incidence sur le système. (Booléen, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.addPolicyType('[-policySet customPolicySet -policyType WSTransaction -enabled true]')
  • A l'aide de la liste Jython :
    AdminTask.addPolicyType(['-policySet', 'customPolicySet', '-policyType', 'WSTransaction', '-enabled', 'true'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.addPolicyType('-interactive')

deletePolicyType

La commande deletePolicyType supprime une règle d'un ensemble de règles.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour supprimer des règles de votre configuration.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles à mettre à jour. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle à supprimer de l'ensemble de règles. (Chaîne, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.deletePolicyType('[-policySet customPolicySet -policyType WSTransaction]')
  • A l'aide de la liste Jython :
    AdminTask.deletePolicyType(['-policySet', 'customPolicySet', '-policyType', 'WSTransaction'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.deletePolicyType('-interactive')

validatePolicySet

La commande validatePolicySet permet de valider la configuration d'ensemble de règles.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour valider des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique l'ensemble de règles à mettre à jour. (Chaîne, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.validatePolicySet('[-policySet customSecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.validatePolicySet(['-policySet', 'customSecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.validatePolicySet('-interactive')

exportPolicySet

La commande exportPolicySet exporte un ensemble de règles sous forme de fichier archive pouvant être copié vers un environnement client.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour exporter des ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique l'ensemble de règles à exporter. (Chaîne, obligatoire)
-pathName
Indique le nom du chemin du fichier archive à créer. (Chaîne, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.exportPolicySet('[-policySet customSecureConversation -pathName  
     C:/IBM/WebSphere/AppServer/PolicySets/customSC.zip]')
  • A l'aide de la liste Jython :
    AdminTask.exportPolicySet(['-policySet', 'customSecureConversation;, '-pathName', ' 
     C:/IBM/WebSphere/AppServer/PolicySets/customSC.zip'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.exportPolicySet('-interactive')

importPolicySet

La commande importPolicySet importe un ensemble de règles d'un fichier archive compressé ou d'une sélection d'ensemble de règles par défaut vers l'environnement serveur.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour importer des ensembles de règles.

Objet cible

Aucun.

Paramètres optionnels

-importFile
Indique le nom du chemin du fichier archive à importer. (Chaîne, optionnelle)
-defaultPolicySet
Indique le nom de l'ensemble de règles par défaut à importer. (Chaîne, optionnelle)
-policySet
Indique le nom à attribuer au nouvel ensemble de règles. Si vous n'indiquez pas ce paramètre, le système utilise le nom d'origine de l'ensemble de règles. (Chaîne, optionnelle)
-verifyPolicySetType
Indique que le type de l'ensemble de règles à importer correspond à un type spécifique. Spécifiez system ousystem/trust pour vérifier que l'ensemble de règles à importer est un type d'ensemble de règles système, incluant des ensembles de règles de service d'accréditation. Spécifiez application pour vérifier que l'ensemble de règles est un ensemble de règles d'application. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.importPolicySet('[-importFile C:/IBM/WebSphere/AppServer/PolicySets/customSC.zip]')
  • A l'aide de la liste Jython :
    AdminTask.importPolicySet(['-importFile', 'C:/IBM/WebSphere/AppServer/PolicySets/customSC.zip'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.importPolicySet('-interactive')

listPolicyTypes

La commande listPolicyTypes renvoie une liste de noms correspondant aux règles configurées sur votre système. Les paramètres en entrée vous permettent de répertorier chaque type configuré dans le système, les types de règles configurés dans un ensemble de règles ou les types de règles d'une liaison.

Si la sécurité administrative est activée, chaque rôle administratif peut énumérer des types de règle.

Objet cible

Aucun.

Paramètres optionnels

-policySet
Indique le nom de l'ensemble de règles permettant de demander des règles. Si l'ensemble de règles n'est pas spécifié, la commande affiche la liste de toutes les règles définies dans votre configuration. (Chaîne, optionnelle)
-bindingLocation
Indique l'emplacement de la liaison. Cette valeur correspond à la liaison par défaut au niveau de la cellule, à la liaison par défaut spécifique au serveur ou à la liaison spécifique à l'association. Spécifiez le paramètre bindingLocation sous la forme d'un objet propriétés, conformément aux instructions suivantes :
  • Pour la liaison par défaut de niveau cellule, utilisez un propriété null ou vide.
  • Pour la liaison par défaut spécifique au serveur, indiquez les noms de noeud et de serveur dans les propriétés. Les noms de propriété sont node et server. Les liaisons par défaut spécifiques au serveur sont dépréciées.
  • Pour la liaison spécifique à l'association, indiquez le nom d'application et l'ID association dans les propriétés. Les noms de ces propriétés sont application et attachmentId.
  • Pour les liaisons système/d'accréditation, attribuez la valeur trustService à la propriété systemType.
  • Pour les liaisons de client sécurisé, affectez à la propriété systemType la valeur trustClient. Indiquez également l'ID de liaison. Si les liaisons concernent une application spécifique, définissez aussi la propriété application.
  • Pour la liaison WSNClient, indiquez le nom du bus, le nom du service et l'ID association dans les propriétés. Les noms de ces propriétés sont bus, WSNService et attachmentId.
(Propriétés, facultatif)
-attachmentType
Indique si le type de liaison est une liaison d'application, une liaison de client, une liaison de service d'accréditation liaisons de client sécurisé, ou une liaison de client WS-Notification. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-bindingName
Indique une liaison générale spécifique. Si vous spécifiez ce paramètre, le système affiche les types d'ensembles de règles de la liaison spécifique. (Chaîne, optionnelle)
-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie la liste des types de règle.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.listPolicyTypes('[-policySet customSecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.listPolicyTypes(['-policySet', 'customSecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.listPolicyTypes ('[-interactive]')

getPolicyType

La commande getPolicyType renvoie les attributs d'une règle spécifiée.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir des attributs de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles à interroger. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle qui vous intéresse. (Chaîne, obligatoire)

Paramètres optionnels

-attributes
Indique les attributs spécifiques à afficher. Si ce paramètre n'est pas utilisé, la commande renvoie tous les attributs de la règle spécifiée. (Chaîne[], facultatif)
-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie un objet propriétés contenant les attributs de la règle.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getPolicyType('[-policySet customSecureConversation -policyType 
     SecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.getPolicyType(['-policySet', 'customSecureConversation', '-policyType', 'SecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getPolicyType (['-interactive'])

setPolicyType

La commande setPolicyType met à jour les attributs d'une règle spécifiée.
Eviter les incidents Eviter les incidents: L'assistance de commande de la console d'administration fournit une syntaxe Jython incorrecte pour la commande setPolicyType. L'expression XPath destinée à la protection de la partie de message de réponse de l'ensemble de règles Username WSSecurity contient une apostrophe (') dans chaque valeur de propriété XPath, ce qui n'est pas pris en charge par Jython. Pour corriger la commande à partir de l'assistance de commande de la console d'administration, ajoutez une barre oblique inversée (\) devant chaque apostrophe pour la protéger.

De plus, si vous utilisez un script Jython pour mettre à jour les attributs, aucun crochet ne doit être inclus si vous souhaitez obtenir une liste d'éléments et non une liste de chaînes.

gotcha

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour configurer des règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles qui vous intéresse. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle qui vous intéresse. (Chaîne, obligatoire)
-attributes
Indique les attributs spécifiques à mettre à jour. Les propriétés peuvent inclure tous les attributs de la règle ou un sous-ensemble d'attributs. (Propriétés, obligatoire)

Paramètres optionnels

-replace
Indique si les nouveaux attributs fournis à partir de la commande remplacent les attributs de règle existants. Pour les règles dotées de données complexes, vous pouvez supprimer des parties facultatives de la configuration, si nécessaire. Utilisez ce paramètre pour extraire tous les attributs, effectuer des modifications et remplacer la configuration de la liaison par les données modifiées. La valeur par défaut est false. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.setPolicyType('[-policySet customSecureConversation -policyType 
     SecureConversation -attributes [[type application] [description [my new description]]]]')
  • A l'aide de la liste Jython :
    AdminTask.setPolicyType(['-policySet', 'customSecureConversation', '-policyType', 'SecureConversation',
     '-attributes',
     '[[type application] [description [my new description]]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.setPolicyType('-interactive')

getPolicyTypeAttribute

La commande getPolicyTypeAttribute renvoie la valeur de l'attribut de règle spécifié.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir les valeurs des attributs du type de règle.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles qui vous intéresse. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle qui vous intéresse. (Chaîne, obligatoire)
-attributeName
Indique le nom de l'attribut qui vous intéresse. (Chaîne, obligatoire)
-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Paramètres optionnels

-fromDefaultRepository
Indique si le référentiel par défaut doit être utilisé. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie une chaîne contenant la valeur de l'attribut spécifié.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getPolicyTypeAttribute('[-policySet customSecureConversation  -policyType 
     SecureConversation -attributeName type]')
  • A l'aide de la liste Jython :
    AdminTask.getPolicyTypeAttribute(['-policySet', 'customSecureConversation',  '-policyType', 
     'SecureConversation', '-attributeName', 'type'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getPolicyTypeAttribute('-interactive')

setPolicyTypeAttribute

La commande setPolicyTypeAttribute définit la valeur de l'attribut de règle spécifié.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur pour configurer des attributs de règle.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles qui vous intéresse. (Chaîne, obligatoire)
-policyType
Indique le nom de la règle qui vous intéresse. (Chaîne, obligatoire)
-attributeName
Indique le nom de l'attribut qui vous intéresse. (Chaîne, obligatoire)
-attributeValue
Indique la valeur de l'attribut qui vous intéresse. (Chaîne, obligatoire)

Valeur renvoyée

Si l'attribut est correctement ajouté dans la règle, la commande renvoie la valeur de chaîne true.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.setPolicyTypeAttribute('[-policySet customPolicySet  -policyType 
     WSReliableMessaging -attributeName specLevel  -attributeValue 1.0]')
  • A l'aide de la liste Jython :
    AdminTask.setPolicyTypeAttribute(['-policySet', 'customPolicySet',  '-policyType', 
     'WSReliableMessaging', '-attributeName', 'specLevel',  '-attributeValue', '1.0'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.setPolicyTypeAttribute('-interactive')

getPolicySetAttachments

La commande getPolicySetAttachments répertorie les propriétés de toutes les associations d'ensemble de règles configurées dans une application déterminée.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir des associations d'ensemble de règles.

Objet cible

Aucun.

Paramètres optionnels

-applicationName
Indique le nom de l'application pour la requête sur les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les requêtes sur les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-expandResources
Fournit des informations étendues détaillant les propriétés d'association pour chaque ressource. Si vous définissez le nom du service pour ce paramètre, seules les ressources de ce service Web sont renvoyées. Si vous définissez un astérisque ( * ), des informations étendues pour tous les services Web sont renvoyées. Ce paramètre est valide si l valeur du paramètre -attachmentType est provider ou client. (Chaîne, optionnelle)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)
-serviceRef
Indique le nom de la référence de service pour laquelle les associations sont renvoyées. Si la référence est spécifiée, seules les associations pour cette référence sont renvoyées. Ce paramètre n'est valide que lorsque la valeur du paramètre expandResources est le nom de votre service et que la valeur client est définie pour le paramètre attachmentType. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie une liste des propriétés de chaque association dans l'application, y compris le nom de l'ensemble de règles, l'ID association et la liste des ressources. Si vous spécifiez le paramètre expandResources, la commande renvoie les propriétés resource, attachmentId, policySet, binding et directAttachment. Si une ressource n'est pas associée à un ensemble de règles, le système affiche uniquement la propriété resource. La propriété binding existe uniquement si l'association contient une liaison personnalisée.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getPolicySetAttachments('[-attachmentType provider -attachmentProperties "[systemType trustService]"]')
  • A l'aide de la liste Jython :
    AdminTask.getPolicySetAttachments(['-attachmentType', 'provider', '-attachmentProperties', 
     '[systemType trustService]'])
Les exemples suivants renvoient des informations sur les associations d'ensemble de règles pour la référence de service spécifiée, myServiceRef. Ils renvoient des informations détaillées sur les ressources relatives aux noeuds finaux logiques et aux opérations pour chaque référence de service, parce que le paramètre -expandResource est spécifié.
  • Avec la chaîne Jython :
    AdminTask.getPolicySetAttachments('[-attachmentType client -applicationName application1 -expandResources {http://www.ibm.com}myService -serviceRef myServiceRef]') 
  • A l'aide de la liste Jython :
    AdminTask.getPolicySetAttachments(['-attachmentType', 'client', '-applicationName', 'application1', '-expandResources', '{http://www.ibm.com}myService', -serviceRef', 'myServiceRef'])

Exemple d'utilisation en mode interactif

  • A l'aide de la liste Jython :
    AdminTask.getPolicySetAttachments('-interactive')

createPolicySetAttachment

La commande createPolicySetAttachment crée une association d'ensemble de règles pour une application.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 1. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour créer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez créer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour créer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez créer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut créer des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas créer d'association d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas créer d'association d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-resources
Indique le nom des ressources d'application à rattacher à l'ensemble de règles. (Chaîne[], obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application concernée pour les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-dynamicClient
Lorsque ce paramètre a pour valeur true, le système ne reconnaît pas les ressources client. Cette option indique que les ressources client ne sont pas validées. (Booléen, facultatif)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)
-inheritFromService
Indique si les ressources pour la référence de service héritent des associations d'ensemble de règles des services associés. N'utilisez ce paramètre que pour les associations de référence de service. Sa valeur par défaut est true. (Booléen, facultatif)
-policySet
Indique le nom de l'ensemble de règles à rattacher. Ce paramètre est requis, sauf si la ressource indique une référence de service et le paramètre inheritFromService est spécifié. Si le paramètre policySet n'est pas spécifié, et le paramètre inheritFromService a la valeur false, toutes les associations de la référence de service sont supprimées et celle-ci n'a pas d'association d'ensemble de règles. Si le paramètre policySet n'est pas spécifié, et le paramètre inheritFromService a la valeur true, toutes les associations de la référence de service sont supprimées et celle-ci hérite des règles du service. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie une chaîne avec l'ID et la nouvelle association.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.createPolicySetAttachment('[-policySet policyset1 -resources "WebService:/" -applicationName WebService -attachmentType provider]')
  • A l'aide de la liste Jython :
    AdminTask.createPolicySetAttachment(['-policySet', 'policyset1', '-resources', '"WebService:/"', 
    '-applicationName', 'WebService',
     '-attachmentType', 'provider'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.createPolicySetAttachment('-interactive')
Environnement de version mixte Environnement de version mixte: Dans un environnement de cellule mixte, vous ne devez pas créer des associations de référence de service ou des associations de ressources spécifiées au format de paire valeur-nom pour des applications déployées sur un serveur d'applications antérieur à WebSphere Application Server version 8.0. Les associations de référence de service sont prises en charge uniquement pour WebSphere Application Server version 8.0 et ultérieure.

Dans un environnement de cellule mixte, vous ne devez pas créer d'associations à des ensembles de règles contenant la règle CustomProperties pour des applications déployées sur un serveur d'applications de version antérieure à la version 8 de WebSphere Application Server. La règle CustomProperties n'est prise en charge que sur WebSphere Application Server Version 8.0 et versions ultérieures.

mixv

updatePolicySetAttachment

La commande updatePolicySetAttachment met à jour les ressources applicables à une association d'ensemble de règles.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 2. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour configurer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez configurer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour configurer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez configurer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut configurer des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas configurer d'association d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas configurer d'association d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-attachmentId
Indique le nom de l'association à mettre à jour. (Chaîne, obligatoire)
-resources
Indique les noms des ressources d'application à rattacher à l'ensemble de règles. La ressource d'une référence de service ne peut pas être incluse dans la même association que la ressource d'un service. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application concernée pour les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-dynamicClient
Lorsque ce paramètre a pour valeur true, le système ne reconnaît pas les ressources client. Cette option indique que les ressources client ne sont pas validées. (Booléen, facultatif)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.updatePolicySetAttachment('[-attachmentId 123 -resources "WebService:/"]')
  • A l'aide de la liste Jython :
    AdminTask.updatePolicySetAttachment(['-attachmentId', '123', '-resources', 
     '"WebService:/"'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.updatePolicySetAttachment ('-interactive')
Environnement de version mixte Environnement de version mixte: Dans un environnement de cellule mixte, vous ne devez pas créer des associations de référence de service ou des associations de ressources spécifiées au format de paire valeur-nom pour des applications déployées sur un serveur d'applications antérieur à la version 8.0. Les associations de référence de service sont prises en charge uniquement pour les versions 8.0 et ultérieures.

Dans un environnement de cellule mixte, vous ne devez pas créer d'associations à des ensembles de règles contenant la règle CustomProperties pour des applications déployées sur un serveur d'applications de version antérieure à la version 8 de WebSphere Application Server. La règle CustomProperties n'est prise en charge que sur WebSphere Application Server Version 8.0 et versions ultérieures.

mixv

addToPolicySetAttachment

La commande addToPolicySetAttachment ajoute des ressources supplémentaires applicables à une association d'ensemble de règles.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 3. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour ajouter des ressources aux associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez ajouter des ressources aux associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour ajouter des ressources aux associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez ajouter des ressources aux associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut ajouter des ressources aux associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas ajouter de ressources aux associations d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas ajouter de ressources aux associations d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-attachmentId
Indique le nom de l'association à mettre à jour. (Chaîne, obligatoire)
-resources
Indique les noms des ressources d'application à rattacher à l'ensemble de règles. La ressource d'une référence de service ne peut pas être incluse dans la même association que la ressource d'un service. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application concernée pour les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-dynamicClient
Lorsque ce paramètre a pour valeur true, le système ne reconnaît pas les ressources client. Cette option indique que les ressources client ne sont pas validées. (Booléen, facultatif)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.addToPolicySetAttachment('[-attachmentId 123 -resources  
     "WebService:/webapp1.war:{http://www.ibm.com}myService"]')
  • A l'aide de la liste Jython :
    AdminTask.addToPolicySetAttachment(['-attachmentId', '123', '-resources',  
     '"WebService:/webapp1.war:{http://www.ibm.com}myService"'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.addToPolicySetAttachment('-interactive')
Environnement de version mixte Environnement de version mixte: Dans un environnement de cellule mixte, vous ne devez pas créer des associations de référence de service ou des associations de ressources spécifiées au format de paire valeur-nom pour des applications déployées sur un serveur d'applications antérieur à la version 8.0. Les associations de référence de service sont prises en charge uniquement pour les versions 8.0 et ultérieures.

Dans un environnement de cellule mixte, vous ne devez pas créer d'associations à des ensembles de règles contenant la règle CustomProperties pour des applications déployées sur un serveur d'applications de version antérieure à la version 8 de WebSphere Application Server. La règle CustomProperties n'est prise en charge que sur WebSphere Application Server, version 8.0 et ultérieure.

mixv

removeFromPolicySetAttachment

La commande removeFromPolicySetAttachment supprime des ressources applicables à une association d'ensemble de règles.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 4. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour supprimer des ressources des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer des ressources auxquelles vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour supprimer des ressources des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut supprimer des ressources des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas supprimer de ressources des associations d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas supprimer de ressources des associations d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-attachmentId
Indique le nom de l'association à supprimer. (Chaîne, obligatoire)
-resources
Indique les noms des ressources d'application à rattacher à l'ensemble de règles. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application concernée pour les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.removeFromPolicySetAttachment('[-attachmentId 123 -resources  
     "WebService:/webapp1.war:{http://www.ibm.com}myService"]')
  • A l'aide de la liste Jython :
    AdminTask.removeFromPolicySetAttachment(['-attachmentId', '123', '-resources',  
     '"WebService:/webapp1.war:{http://www.ibm.com}myService"'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.removeFromPolicySetAttachment('-interactive')

deletePolicySetAttachment

La commande deletePolicySetAttachment supprime d'une application une association d'ensemble de règles.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 5. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour supprimer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour supprimer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut supprimer des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas supprimer d'association d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas supprimer d'association d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-attachmentId
Indique le nom de l'association à supprimer. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application concernée pour les associations d'ensemble de règles. Ce paramètre est obligatoire pour les associations d'application et de client. Ce paramètre n'est pas nécessaire pour les associations de service d'accréditation. (Chaîne, optionnelle)
-attachmentType
Indique le type de l'association d'ensemble de règles. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de spécifier les propriétés bus et WSNService. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et utilisez le paramètre -attachmentProperties afin de définir la propriété systemType sur trustService. Si une association de client sécurisé est spécifiée, le paramètre -attachmentProperties contient une propriété systemType avec la valeur trustClient. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.deletePolicySetAttachment('[-attachmentId 123]')
  • A l'aide de la liste Jython :
    AdminTask.deletePolicySetAttachment(['-attachmentId', '123'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.deletePolicySetAttachment('-interactive')

listAssetsAttachedToPolicySet

La commande listAssetsAttachedToPolicySet répertorie les applications auxquelles un ensemble de règles spécifique est rattaché.

Si la sécurité administrative est activée, chaque rôle administratif peut énumérer des applications qui sont associées aux ensembles de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles qui vous intéresse. (Chaîne, obligatoire)

Paramètres optionnels

-attachmentType
Indique le type de l'association d'ensemble de règles. La valeur de ce paramètre doit être provider, client, WSNClient, WSMex, cuProvider, cuClient, binding ou all. La valeur par défaut est all. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie la liste des propriétés décrivant chaque actif. Chaque objet propriétés contient la propriété assetType qui spécifie le type d'actif.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.listAssetsAttachedToPolicySet('[-policySet SecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.listAssetsAttachedToPolicySet(['-policySet', 'SecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.listAssetsAttachedToPolicySet('-interactive')

listAttachmentsForPolicySet

La commande listAttachmentsForPolicySet répertorie les applications auxquelles un ensemble de règles spécifique est rattaché.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir des associations d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles qui vous intéresse. (Chaîne, obligatoire)

Paramètres optionnels

-attachmentType
Indique le type de l'association d'ensemble de règles. La valeur de ce paramètre doit être application, client ou system/trust. La valeur par défaut est application. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie une liste de noms d'application.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.listAttachmentsForPolicySet('[-policySet SecureConversation]')
  • A l'aide de la liste Jython :
    AdminTask.listAttachmentsForPolicySet(['-policySet', 'SecureConversation'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.listAttachmentsForPolicySet('-interactive')

deleteAttachmentsForPolicySet

La commande deleteAttachmentsForPolicySet supprime toutes les associations pour un ensemble de règles déterminé.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 6. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour supprimer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour supprimer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez supprimer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut supprimer des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas supprimer d'association d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas supprimer d'association d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-policySet
Indique le nom de l'ensemble de règles dans lequel supprimer les associations. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application qui vous intéresse. Cette commande ne supprime les associations de l'application concernée que si vous spécifiez ce paramètre. (Chaîne, optionnelle)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Vous pouvez spécifier des valeurs pour les propriétés bus et WSNService. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.deleteAttachmentsForPolicySet('[-policySet customSecureConversation  
     -applicationName newApp1]')
  • A l'aide de la liste Jython :
    AdminTask.deleteAttachmentsForPolicySet(['-policySet', 'customSecureConversation',  
     '-applicationName', 'newApp1'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.deleteAttachmentsForPolicySet('-interactive')

transferAttachmentsForPolicySet

La commande transferAttachmentsForPolicySet transfère toutes les associations d'un ensemble de règles vers un autre ensemble de règles.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 7. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour transférer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez transférer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour transférer des associations d'ensemble de règles. Si vous avez accès à une ressource spécifique uniquement, vous pouvez transférer des associations d'ensemble de règles pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut transférer des associations d'ensemble de règles pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas transférer d'association d'ensemble de règles.
Moniteur Le rôle Moniteur ne peut pas transférer d'association d'ensemble de règles.

Objet cible

Aucun.

Paramètres requis

-sourcePolicySet
Indique l'ensemble de règles source à partir duquel copier des associations. (Chaîne, obligatoire)
-destinationPolicySet
Indique le nom de l'ensemble de règles vers lequel les associations sont copiées. (Chaîne, obligatoire)

Paramètres optionnels

-applicationName
Indique le nom de l'application qui vous intéresse. Cette commande ne transfère les associations de l'application concernée que si vous spécifiez ce paramètre. (Chaîne, optionnelle)
-attachmentProperties
Indique les informations requises pour identifier l'emplacement de l'association. Vous pouvez spécifier des valeurs pour les propriétés bus et WSNService. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.transferAttachmentsForPolicySet('[-sourcePolicySet SecureConversation 
     -destinationPolicySet customSecureConversation -applicationName newApp1]')
  • A l'aide de la liste Jython :
    AdminTask.transferAttachmentsForPolicySet(['-sourcePolicySet', 'SecureConversation', 
     '-destinationPolicySet', 'customSecureConversation', '-applicationName', 'newApp1'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.transferAttachmentsForPolicySet('-interactive')

listSupportedPolicySets

La commande listSupportedPolicySets renvoie la liste des ensembles de règles pouvant être associés à vos ressources de services Web. Si la sécurité administrative est activée, chaque rôle utilisateur peut utiliser cette commande.

Objet cible

Aucun.

Paramètres requis

-assetProps
Spécifie le nom de l'actif concerné. Indiquez le nom de l'application comme valeur de la propriété application. (Propriétés, obligatoire)
Les paires propriété/valeur prises en charge pour ce paramètre sont les suivantes :
Propriété valeur
application Nom de l'application, par exemple myApplication
Client de service WS-Notification :
  • bus
  • WSNService
Noms des clients de service :
  • Nom de bus, par exemple bus1
  • Nom de service, par exemple service1
Ressource de service d'accréditation :
  • systemType
Nom de ressource de service :
  • trustService

Valeur renvoyée

La commande renvoie la liste des ensembles de règles pris en charge. Chaque entrée de la liste correspond au nom d'un ensemble de règles.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.listSupportedPolicySets ('[-assetProps [[application myApplication]]]')
  • A l'aide de la liste Jython :
    AdminTask.listSupportedPolicySets (['-assetProps', '[[bus bus1] [WSNService service1]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.listSupportedPolicySets('-interactive')

getBinding

La commande getBinding renvoie la configuration de liaison pour une règle et une portée spécifiées. Vous pouvez utiliser cette commande pour renvoyer une liste de liaisons personnalisées disponibles contenant des liaisons référencées et non référencées par des associations.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir des informations de configuration de liaison.

Pour les utilisateurs en transition Pour les utilisateurs en transition: Dans WebSphere Application Server version 7.0 et les versions ultérieures, le modèle de sécurité était amélioré de sorte à être centré sur le domaine et non plus centré sur le serveur. La configuration du niveau de sécurité globale par défaut ( cellule) et les liaisons par défaut au niveau du serveur ont également changé dans cette version du produit. Dans WebSphere Application Server version 6.1 Feature Pack for Web Services, vous pouvez configurer un ensemble de liaisons par défaut pour la cellule et configurer en option un ensemble de liaisons par défaut pour chaque serveur. Dans la version 7.0 et les versions ultérieures, vous pouvez configurer une ou plusieurs liaisons générales de fournisseur de services et une ou plusieurs liaisons générales de client de services. Après avoir configuré des liaisons générales, vous pouvez choisir la liaison par défaut parmi celles-ci. Vous pouvez éventuellement spécifier des liaisons générales utilisées par défaut pour un serveur d'applications ou un domaine de sécurité. trns

Pour prendre en charge un environnement à cellules mixtes, WebSphere Application Server prend en charge des liaisons version 7.0 et version 6.1. Les liaisons générales de niveau cellule sont spécifiques à la version 7.0. Les liaisons propres à l'application restent à la version requise par celle-ci. Lorsque l'utilisateur crée une liaison propre à l'application, le serveur d'applications détermine la version de liaison requise à utiliser pour celle-ci.

Objet cible

Aucun.

Paramètres requis

-policyType
Indique la règle qui vous intéresse. (Chaîne, obligatoire)
-bindingLocation
Indique l'emplacement de la liaison. (Propriétés, obligatoire)
Spécifiez le paramètre bindingLocation sous la forme d'un objet propriétés, conformément aux instructions suivantes :
  • Pour les liaisons par défaut de serveur WebSphere Application Server, version 7.0 et ultérieure, spécifiez des propriétés vides ou de type null. Utilisez le paramètre bindingName pour identifier l'emplacement de la liaison.
  • Pour les liaisons spécifiques à l'association, indiquez le nom d'application et l'ID association dans les propriétés. Les noms de ces propriétés sont application et attachmentId.
  • Pour les liaisons WSNClient, indiquez le nom du bus, le nom du service et l'ID association dans les propriétés. Les noms de ces propriétés sont bus, WSNService et attachmentId. Si vous spécifiez un astérisque (*) comme ID d'association, la commande renvoie la liste des noms de liaison correspondant au type d'association concerné.
  • Pour les liaisons système/d'accréditation, attribuez la valeur trustService à la propriété systemType.

Paramètres optionnels

-attachmentType
Indique le type de l'association d'ensemble de règles. Utilisez ce paramètre pour faire la distinction entre les types de liaison personnalisée employés dans les associations. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-attributes
Indique les noms des attributs à renvoyer. Si ce paramètre n'est pas spécifié, la commande renvoie tous les attributs. (Chaîne, optionnelle)
-bindingName
Indique le nom de la liaison concernée. Spécifiez ce paramètre pour afficher une liaison générale au niveau de la cellule ou une liaison d'association personnalisée. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un objet propriétés contenant les attributs de configuration demandés pour la liaison de règles.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    L'exemple suivant renvoie une liste de liaisons d'application :
    AdminTask.getBinding('[-policyType WSAddressing -attachmentType provider 
     -bindingLocation [[application nom_application] [attachmentId *]]]')
    L'exemple suivant renvoie une liste de liaisons client :
    AdminTask.getBinding('[-policyType WSAddressing -attachmentType client 
     -bindingLocation [[application nom_application] [attachmentId *]]]')
    L'exemple suivant renvoie une liste de liaisons système :
    AdminTask.getBinding('[-policyType WSAddressing -attachmentType provider 
     -bindingLocation [[systemType trustService] [application nom_application] [attachmentId *]]]')
  • A l'aide de la liste Jython :
    AdminTask.getBinding(['-policyType', 'WSAddressing', '-bindingLocation', '""'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getBinding('-interactive')

setBinding

La commande setBinding met à jour la configuration de liaison pour une règle spécifiée. Cette commande permet d'ajouter une liaison spécifique au serveur, de mettre à jour une association pour utiliser une liaison personnalisée, d'éditer des attributs de liaison ou de supprimer une configuration de liaison.

Si la sécurité administrative est activée, vérifiez que vous utilisez le rôle administratif correct, comme indiqué dans le tableau suivant :
Tableau 8. Rôles d'administration. Ce tableau répertorie les rôles d'administration et l'autorisation associée lorsque la sécurité d'administration est activée.
Rôle administratif Autorisation
Administrateur Le rôle Administrateur doit avoir accès au niveau de la cellule pour configurer des liaisons. Si vous avez accès à une ressource spécifique uniquement, vous pouvez configurer des liaisons personnalisées pour la ressource à laquelle vous avez accès. Le rôle Administrateur est le seul rôle qui peut modifier les configurations de liaison.
Configurateur Le rôle Configurateur doit avoir accès au niveau de la cellule pour affecter ou libérer des liaisons. Si vous avez accès à une ressource spécifique uniquement, vous pouvez affecter et libérer des liaisons personnalisées pour la ressource à laquelle vous avez accès.
Responsable du déploiement Le rôle Responsable de déploiement avec accès au niveau de la cellule ou à une ressource spécifique peut affecter ou libérer des liaisons pour les ressources de l'application uniquement.
Opérateur Le rôle Opérateur ne peut pas configurer les liaisons.
Moniteur Le rôle Moniteur ne peut pas configurer les liaisons.
Pour les utilisateurs en transition Pour les utilisateurs en transition: Dans WebSphere Application Server version 7.0 et les versions ultérieures, le modèle de sécurité était amélioré de sorte à être centré sur le domaine et non plus centré sur le serveur. La configuration du niveau de sécurité globale par défaut ( cellule) et les liaisons par défaut au niveau du serveur ont également changé dans cette version du produit. Dans WebSphere Application Server version 6.1 Feature Pack for Web Services, vous pouvez configurer un ensemble de liaisons par défaut pour la cellule et configurer en option un ensemble de liaisons par défaut pour chaque serveur. Dans la version 7.0 et les versions ultérieures, vous pouvez configurer une ou plusieurs liaisons générales de fournisseur de services et une ou plusieurs liaisons générales de client de services. Après avoir configuré des liaisons générales, vous pouvez choisir la liaison par défaut parmi celles-ci. Vous pouvez éventuellement spécifier des liaisons générales utilisées par défaut pour un serveur d'applications ou un domaine de sécurité. trns

Pour prendre en charge un environnement à cellules mixtes, WebSphere Application Server prend en charge des liaisons version 7.0 et version 6.1. Les liaisons générales de niveau cellule sont spécifiques à la version 7.0. Les liaisons propres à l'application restent à la version requise par celle-ci. Lorsque l'utilisateur crée une liaison propre à l'application, le serveur d'applications détermine la version de liaison requise à utiliser pour celle-ci.

Objet cible

Aucun.

Paramètres requis

-bindingLocation
Indique l'emplacement de la liaison. (Propriétés, obligatoire)
Spécifiez le paramètre bindingLocation sous la forme d'un objet propriétés, conformément aux instructions suivantes :
  • Pour les liaisons par défaut de serveur WebSphere Application Server, version 7.0 et ultérieure, spécifiez des propriétés vides ou de type null. Utilisez le paramètre bindingName pour identifier l'emplacement de la liaison.
  • Pour une liaison spécifique à l'association, indiquez le nom d'application et l'ID association dans les propriétés. Les noms de ces propriétés sont application et attachmentId.
  • Pour les liaisons WSNClient, indiquez le nom du bus, le nom du service et l'ID association dans les propriétés. Les noms de ces propriétés sont bus, WSNService et attachmentId. Si vous spécifiez un astérisque (*) comme ID d'association, la commande renvoie la liste des noms de liaison correspondant au type d'association concerné.
  • Pour les liaisons système/d'accréditation, attribuez la valeur trustService à la propriété systemType.
-policyType
Indique la règle qui vous intéresse. (Chaîne, obligatoire)

Paramètres optionnels

-attachmentType
Indique le type de l'association d'ensemble de règles. Utilisez ce paramètre pour faire la distinction entre les types de liaison personnalisée employés dans les associations. (Chaîne, optionnelle)
Pour les utilisateurs en transition Pour les utilisateurs en transition: Bien qu'il soit possible d'indiquer la valeur application pour le paramètre -attachmentType, utilisez la valeur provider à la place de la valeur application, car les associations sont utilisées par les applications, mais également par les associations système pour le service d'accréditation. Pour les associations d'ensembles de règles système, attribuez la valeur provider au paramètre attachmentType et la valeur "[systemType trustService]" au paramètre -attachmentProperties. Pour les associations WSNClient, attribuez la valeur client au paramètre attachmentType et les propriétés bus et WSNService au paramètre -attachmentProperties.trns
-attributes
Indique les valeurs d'attribut à mettre à jour. Ce paramètre peut inclure tous les attributs de liaison de la règle ou un sous-ensemble à mettre à jour. Si le paramètre attributes n'est pas spécifié, la commande ne met à jour que l'emplacement de liaison utilisé par l'association indiquée. (Propriétés, facultatif)
-bindingName
Indique le nom de la liaison. Spécifiez ce paramètre pour attribuer un nouveau nom à la liaison d'association ou à la liaison au niveau de la cellule. Si celui-ci n'est pas spécifié, un nom est généré. (Chaîne, optionnelle)
-domainName
Indique le nom de domaine de la liaison. Ce paramètre est requis lors de l'utilisation de la commande pour créer une liaison dans un domaine spécifique autre que le domaine de sécurité administrative. La valeur par défaut est global. (Chaîne, optionnelle)
-replace
Indique si tous les attributs de liaison existants doivent être remplacés par les attributs indiqués dans la commande. Utilisez ce paramètre pour supprimer des parties facultatives de la configuration pour les règles comportant des données complexes. La valeur par défaut est false. (Booléen, facultatif)
-remove
Indique si une liaison par défaut spécifique au serveur doit être supprimée ou si une liaison personnalisée doit être supprimée d'une association. Vous ne pouvez pas supprimer la liaison par défaut de niveau cellule. La valeur par défaut est false. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.setBinding('[-policyType WSAddressing -bindingLocation [[application myApplication] [attachmentId 123]] -attributes "[preventWLM false]"
     -attachmentType provider]')
  • A l'aide de la liste Jython :
    AdminTask.setBinding(['-policyType', 'WSAddressing', '-bindingLocation', '[[application myApplication]
     [attachmentId 123]]', '-attributes', '[preventWLM
     false]', '-attachmentType', 'provider'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.setBinding('-interactive')

getDefaultBindings

La commande getDefaultBindings affiche les liaisons par défaut fournisseur et client si les liaisons sont définies. Si la commande ne renvoie pas de sortie, la liaison par défaut du système est la valeur par défaut actuelle.

Si la sécurité administrative est activée, chaque rôle administratif peut requérir des liaisons par défaut.

Objet cible

Aucun.

Paramètres optionnels

-bindingLocation
Indique l'emplacement de la liaison. Spécifiez le paramètre bindingLocation sous la forme d'un objet propriétés, avec des valeurs pour les propriétés node et server. (Propriétés, facultatif)
-domainName
Indique le nom de domaine de la liaison concernée. Ce paramètre est requis si le domaine concerné ne se trouve pas dans le domaine de sécurité globale et que vous n'avez pas spécifié le paramètre bindingLocation. Les paramètres bindingLocation et domainName sont mutuellement exclusifs. La valeur par défaut est global. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un objet propriétés qui contient les noms des liaisons par défaut fournisseur et client, si les liaisons sont définies.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getDefaultBindings('[-bindingLocation [[node myNode] [server myServer]]]')
  • A l'aide de la liste Jython :
    AdminTask.getDefaultBindings(['-bindingLocation', '[[node myNode] [server myServer]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getDefaultBindings('-interactive')

getRequiredBindingVersion

La commande getRequiredBindingVersion affiche le numéro de version de la liaison pour une application spécifique.

Objet cible

Aucun.

Paramètres optionnels

-assetProps
Indique le nom de l'application qui vous intéresse. (Propriétés, facultatif)

Valeur renvoyée

La commande renvoie le numéro de version de la liaison sous forme de numéro, tel que 7.0.0.0 ou 6.1.0.0.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.getRequiredBindingVersion('[-assetProps [[application myApplication]]]')
  • A l'aide de la liste Jython :
    AdminTask.getRequiredBindingVersion(['-assetProps', '[[application myApplication]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.getRequiredBindingVersion('-interactive')

setDefaultBindings

La commande setDefaultBinding définit une liaison en tant que liaison par défaut.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur avec accès au niveau de la cellule pour configurer des liaisons. Si vous utilisez le rôle Administrateur et n'avez pas accès au niveau de la cellule, vous ne pouvez configurer que des liaisons sur des ressources pour lesquelles vous avez accès.

Objet cible

Aucun.

Paramètres requis

-defaultBindings
Indique les noms des liaisons par défaut pour le fournisseur, le client ou les deux. (Propriétés, obligatoire)

Paramètres optionnels

-bindingLocation
Indique l'emplacement de la liaison. Spécifiez le paramètre bindingLocation sous la forme d'un objet propriétés, avec des valeurs pour les propriétés node et server. (Propriétés, facultatif)
-domainName
Indique le nom de domaine de la liaison concernée. Ce paramètre est requis si le domaine concerné ne se trouve pas dans le domaine de sécurité globale et que vous n'avez pas spécifié le paramètre bindingLocation. Les paramètres bindingLocation et domainName sont mutuellement exclusifs. La valeur par défaut est global. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie la valeur true si la commande parvient à définir la liaison par défaut.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.setDefaultBindings('[-defaultBindings [[provider myDefaultProviderBinding] 
    [client myDefaultClientBinding]] -bindingLocation [[node myNode] [server myServer]]]')
  • A l'aide de la liste Jython :
    AdminTask.setDefaultBindings(['-defaultBindings', '[[provider myDefaultProviderBinding' [client myDefaultClientBinding]]', '-bindingLocation', '[[node 
     myNode] [server myServer]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.setDefaultBindings('-interactive')

exportBinding

La commande exportBinding exporte une liaison générale de niveau cellule dans un fichier archive. Vous pouvez copier ce fichier dans un environnement client ou importer l'archive dans un environnement serveur.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur avec accès au niveau de la cellule pour exporter des liaisons.

Objet cible

Aucun.

Paramètres requis

-bindingName
Indique le nom de la liaison à affecter comme liaison par défaut. Si vous n'indiquez pas ce paramètre, le système spécifie la valeur par défaut du système comme liaison par défaut. (Chaîne, obligatoire)
-pathName
Indique le chemin d'accès du fichier archive à créer. (Chaîne, obligatoire)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.exportBinding('[-bindingName myDefaultBinding -pathName 
     C:/IBM/WebSphere/AppServer/PolicySets/Bindings/]')
  • A l'aide de la liste Jython :
    AdminTask.exportBinding(['-bindingName', 'myDefaultBinding', '-pathName',
     'C:/IBM/WebSphere/AppServer/PolicySets/Bindings/'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.exportBinding('-interactive')

importBinding

La commande importBinding importe une liaison générale au niveau de la cellule d'un fichier archive compressé vers un environnement serveur.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur avec accès au niveau de la cellule pour exporter des liaisons.

Objet cible

Aucun.

Paramètres requis

-pathName
Indique le chemin d'accès du fichier archive à importer. (Chaîne, obligatoire)

Paramètres optionnels

-bindingName
Indique le nom de la liaison à affecter comme liaison importée. Si vous n'indiquez pas ce paramètre, le système spécifie le nom de la liaison dans le fichier archive. (Chaîne, optionnelle)
-domainName
Spécifie un nouveau nom de domaine de la liaison à importer. Si vous n'indiquez pas ce paramètre, la commande utilise le domaine spécifié dans le fichier archive. (Chaîne, optionnelle)
-verifyBindingType
Vérifie que le type de liaison à importer correspond à un type de liaison spécifique. Spécifiez provider pour vérifier que la liaison est une liaison fournisseur ou spécifiez client pour vérifier qu'il s'agit d'une liaison client. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.importBinding('[-bindingName myDefaultBinding -pathName 
     C:/IBM/WebSphere/AppServer/PolicySets/Bindings/myBinding.ear]')
  • A l'aide de la liste Jython :
    AdminTask.importBinding(['-bindingName', 'myDefaultBinding', '-pathName', 
     'C:/IBM/WebSphere/AppServer/PolicySets/Bindings/myBinding.ear'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.importBinding('-interactive')

copyBinding

La commande copyBinding crée une liaison générale au niveau de la cellule à partir d'une liaison existante.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur avec accès au niveau de la cellule pour copier des liaisons.

Objet cible

Aucun.

Paramètres requis

-sourceBinding
Spécifie le nom de la liaison existante utilisée par le système pour créer la nouvelle liaison. (Chaîne, obligatoire)
-newBinding
Indique le nom de la liaison à créer. (Chaîne, obligatoire)

Paramètres optionnels

-newDescription
Indique la description de la nouvelle liaison. (Chaîne, optionnelle)
-domainName
Indique le nom de domaine de la liaison. Ce paramètre n'est requis que si la liaison porte sur un domaine autre que celui de la liaison source. (Chaîne, optionnelle)

Valeur renvoyée

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.copyBinding('[-sourceBinding mySourceBinding -newBinding mySourceCopyBinding]')
  • A l'aide de la liste Jython :
    AdminTask.copyBinding(['-sourceBinding', 'mySourceBinding', '-newBinding',
     'mySourceCopyBinding'])

Exemple d'utilisation en mode interactif

  • A l'aide de la liste Jython :
    AdminTask.copyBinding('-interactive')

upgradeBindings

La commande upgradeBindings met à niveau les liaisons d'application pour un actif spécifique dans la version la plus récente.

Si la sécurité administrative est activée, vous devez utiliser le rôle Administrateur avec accès au niveau de la cellule pour exporter des liaisons.

Objet cible

Aucun.

Paramètres requis

-assetProps
Spécifie le nom de l'actif concerné. Indiquez le nom de l'application comme valeur de la propriété application. (Propriétés, obligatoire)

Paramètres optionnels

Aucun

Valeur de retour

La commande renvoie un message de réussite ou d'échec.

Exemple d'utilisation en mode de traitement par lots

  • Avec la chaîne Jython :
    AdminTask.upgradeBindings('[-assetProps [[application myApplication]]]')
  • A l'aide de la liste Jython :
    AdminTask.upgradeBindings(['-assetProps', '[[application myApplication]]'])

Exemple d'utilisation en mode interactif

  • En langage Jython :
    AdminTask.upgradeBindings('-interactive')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_wsfppolicyset
Nom du fichier : rxml_wsfppolicyset.html