Re: [MSH] <INPUT REQUESTED> Standard Verbs

Tech-Archive recommends: Fix windows errors by optimizing your registry

If/as I can get past the formatting <g> I believe I may have
some comments based on quick read (attempt) and recall of
a much earlier fully commented draft.
It appears to me that there is redundancy - particularly in the
parameters (on which I do recognize you did not solicit comment) -
Some of the redundancy I dislike is using one verb in one command set
but then a different in another for what are effectively the same type of
operation.

"Jeffrey Snover [MSFT]" <jsnover@xxxxxxxxxxxxx> wrote in message
news:u2FCtoiEGHA.716@xxxxxxxxxxxxxxxxxxxxxxx
> We are considering changes to more stringently enforce the VERB naming
> standard.
> One of the options is to make non-standard VERBs very prominent during
> interactive startup. (think "List of Shame")
> Before we do that, we'd like to make sure that we have the right set of
> VERBS. It is very important to make this a minimal but complete list.
>
> Please review the standard Verbs and let me know if you have scenarios
> which cannot be made to fit to these.
> Thanks!
> Common Object Verb Set
> Common object Verbs
> Definition
> Common Parameters
> Obsoletes
> Pair
>
> Add
> Add, append or attach an element
> At, After, Before, Create, Filter, Force, ID, Name, Value
> append, attach, concatenate,insert
> Remove
>
> Clear
> Remove all the elements or content of a container
>
> flush,erase, release, unmark, unset,nullify
>
>
> Copy
> Copy a resource to another name or another container
> Container, Destination, Overwrite, Recurse, Strict
> duplicate, clone,replicate
>
>
> Get
> -object -content -ChildItem
> All, As, Compatible, Continuous, Count, Encoding, Exclude, Filter,
> Include, ID, Interval, Name, Path, Property, Recurse, Scope, Sortby,
> read,open, cat, type, dir, obtain, dump, acquire, examine, find,
> search,google
> Set
>
> Lock
>
>
>
> Unlock
>
> Move
> Move a resource
>
> transfer, name, migrate
>
>
> New
> create a new resource
> Description, ID, Name, Value
> create, generate,build, make, allocate
> Remove
>
> Remove
> Remove a resource from a container
> (Get), Drain, Erase, Force
> delete, disconnect, detach,drop, purge,flush,erase, release
> Add/New
>
> Rename
> Give a resource a new name
>
>
>
>
> Set
> -object -content -ChildItem
> Passthru,
> write, reset, assign, configure
> Get
>
> Unlock
>
>
>
> Lock
>
>
>
>
>
>
>
>
>
>
>
> Data Verb Set
> Data Verbs
> Definition
> Common Parameters
> Obsoletes
> Pair
>
> Backup
> Make a copy of state
>
>
>
>
> Checkpoint
> Create a snapshot of the current state of data or configuration so
> that it could be Restored later
> Description, Name, Scope
> Diff
> Restore
>
> Compare
> Compare this resource with another one and produce a set of
> differences
>
> Diff
>
>
> Convert
> Change from one encoding to another or from one unit base to another
> (e.g. feet to meters)
>
>
>
>
> Export
> Make a copy of a set of resources using an interchange format
> (get), Add, As, AsScript, Delete, Description, FileName, Location,
> Strict, Whatif
> extract,backup
> Import
>
> Import
> Create a set of resources using an interchange format
> FileName, Location
> bulk load, load
> Export
>
> Initialize
> Prepare a resource for use. Assign a beginning value to something
>
> erase, renew, rebuild, reinitialize, setup
>
>
> Limit
> Limit the consumption of a resource or apply a constraint on a
> resource
>
> quota
>
>
> Merge
> Take multiple instances and create a single instance
>
> coalesce
>
>
> Restore
> Rollback state to a predefined snapshot/checkpoint
>
>
> Checkpoint
>
> Update
> update or refresh a resource from a source of truth
>
> refresh, renew, recalculate, reindex
>
>
>
>
>
>
>
>
>
>
>
>
>
> LifeCycle Verb Set
> Lifecycle Verbs
> Definition
> Common Parameters
> Obsoletes
> Pair
>
> Disable
> Stop and/or configure something to be unavailable (e.g unable to not
> start again)
>
>
> Enable
>
> Enable
> Configure to be available (e.g. able to start)
>
>
> Disable
>
> Install
> Settle in an indicated place or condition (optionally initializing for
> use)
>
> setup, load
> Uninstall
>
> Restart
> Terminate existing activity and begin it again (with the same or
> checkpointed configuration)
>
> recycle
>
>
> Resume
> Begin an activity again after it was suspended
>
>
> Suspend
>
> Start
> Begin an activity
>
> launch, initiate, boot
> Stop
>
> Stop
> Discontinue or cease an activity
>
> End, kill, terminate, cancel
> Start
>
> Suspend
> Suspend an activity temporarily
>
> Pause
> Resume
>
> Uninstall
>
>
>
> Install
>
>
>
>
>
>
>
>
>
>
>
> Diagnostics Verb Set
> Diagnostics verb
> Definition
> Common Parameters
> Obsoletes
> Pair
>
> Debug
> Interatively interact with a resource or activity for the purpose of
> finding a flaw or better understanding of what is occurring.
>
>
>
>
> Measure
> calculate/identify resources consumed by a specified operation or
> retrieve statistics about a resource
>
>
>
>
> Ping
> Determine whether a resource is alive and responding to requests
>
>
>
>
> Resolve
> Map a shorthand name will be bound to a longname
>
> where,which
>
>
> Test
> Verify the operational validity or consistency of a resource
>
> diagnose,verify,analyze,salvage,verify
>
>
> Trace
> Trace activies performed by a specified operation
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
> Communications Verb Set
> Communications
> Definition
> Common Parameters
> Obsoletes
> Pair
>
> Write
> Convey by an intermediary to a destination
>
> put, broadcast, mail,fax,
> Read
>
> Read
> Take or acquire from a source
>
> accept, peek,
> Write
>
> Connect
> Associate subsequent activies with a resource
>
>
> disconnect
>
> Disconnect
>
>
>
> Connect
>
>
>
>
>
>
>
>
> --
> Jeffrey Snover [MSFT]
> Windows Command Shell Architect
> Microsoft Corporation
> This posting is provided "AS IS" with no warranties, and confers no
> rights.
>
>
>


.

Relevant Pages

  • [MSH] Standard Verbs
    ... Common Object Verb Set ... Common Parameters ... Obsoletes ... Copy a resource to another name or another container ...
    (microsoft.public.windows.server.scripting)
  • Re: Standard Verbs
    ... COMMON OBJECT VERBS ... "write" verb obsolet in this case would work out. ... Backup Create a copy of a resource ... So does that mean current meaning of "Backup" will be revised to be ...
    (microsoft.public.windows.server.scripting)