containerBind

Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

containerBind [-allNames] [-bindingSet string] [-bindingSetConditions] [-bindingSetList] [-force] [-preview]

containerBind is undoable, queryable, and editable.

Return value

None

In query mode, return type is based on queried flag.

Keywords

Related

Flags

Long name (short name)	Argument types	Properties
-allNames(-all)
Specifies that all published names on the container should be considered during the binding operation. By default only unbound published names will be operated on. Additionally specifying the 'force' option with 'all' will cause all previously bound published names to be reset (or unbound) before the binding operation is performed; in the event that there is no appropriate binding found for the published name, it will be left in the unbound state.
-bindingSet(-bs)	string
Specifies the name of the template binding set to use for the bind or query operation. This flag is not available in query mode. In query mode, this flag needs a value.
-bindingSetConditions(-bsc)
Used in query mode, returns a list of binding set condition entries from the specified template binding set. The list returned is composed of of all published name / condition string pairs for each entry in the binding set. This flag returns all entries in the associated binding set and does not take into account the validity of each entry with respect to the container's list of published names, bound or unbound state, etc.
-bindingSetList(-bsl)
Used in query mode, returns a list of available binding sets that are defined on the associated container template.
-force(-f)
This flag is used to force certain operations to proceed that would normally not be performed.
-preview(-p)
This flag will provide a preview of the results of a binding operation but will not actually perform it. A list of publishedName/boundName pairs are returned for each published name that would be affected by the binding action. If the binding of a published name will not change as a result of the action it will not be listed. Published names that were bound but will become unbound are also listed, in this case the associated boundName will be indicated by an empty string.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

// query the template binding sets available for this container
//
containerBind -query -bindingSetList container1;

// attempt to bind published names on the container
// using matching information in the bindingSet specified.
// By default only unbound names are considered.
//
containerBind -bindingSet "MayaBindings" container1;

// Attempt to bind all published names on the container
// using matching information in the bindingSet specified.
// Previously bound names will only be re-bound if the bindingSet
// produces an appropriate match.
//
containerBind -bindingSet "MayaBindings" -allNames container1;

// Forcibly re-bind all published names on the container
// using matching information in the bindingSet specified.
// All previously bound names will be unbound and will only
// be re-bound if the binding set produces an appropriate match.
//
containerBind -bindingSet "MayaBindings" -force -allNames container1;

// preview what the results of a binding operation would be, but do
// not actually perform it.
containerBind -preview -bindingSet "MayaBindings" -force -all container1;