Soliciting New Verbs

re: Soliciting New Verbs

PowerShell Team — Wed, 10 Jun 2009 18:13:39 GMT

We felt that the Convert verbs cover those scenarios well. The .NET Framework even follows this by hanging the Base64 methods on the Convert class.

Lee Holmes [MSFT]

Windows PowerShell Development

Microsoft Corporation

re: Soliciting New Verbs

Joel "Jaykul" Bennett — Wed, 10 Jun 2009 16:45:41 GMT

What about Encode/Decode (as in Encrypt/Decrypt or Base64, or BarCodes or Morse Code) ... what verb pair on there you would stand in for that?

re: Soliciting New Verbs

Cybertech — Thu, 07 May 2009 21:57:58 GMT

How about Upgrade as this is a common lifecycle concept for administrators and the other terms (namely update and install) have different connotations that will potentially cause confusion.

Proposed upgrade verb in template format:

Verb name = Upgrade

Description = Upgrade is used to perform major version or minor patch level changes to a product, operating system, data, or files. Upgrade may not be reversible (See downgrade) depending on the inherit upgrade abilities and structure of the item being upgraded.

Category = Lifecycle

Domains = SQL Server, SharePoint, other server applications or even file types.

Alt verbs = Set, Update, Install

Reciprocal verb would be Downgrade

re: Soliciting New Verbs

MikeTheTechGeek — Mon, 04 May 2009 22:55:04 GMT

Verb name: watch

Description: used to watch process in action and potentially alert if a certain even triggers

Category: Diagnostic

List of at least 5 significantly different applicable domains: file, account, process, copy, move, search, merge

List of at least 3 alternative verbs from the approved list: Test, Measure, Show

Pair with: unknown

re: Soliciting New Verbs

Stephen Mills — Sun, 03 May 2009 18:22:56 GMT

Verb name: Script

Category: Common

Applicable Domains: Windows shares, Active Directory, Databases, IIS, Exchange, Virtual Server

Alternative Verbs: Get, Backup, Export

Pair with: Not Applicable

Description: Used to generate a script to recreate an object that is easy to modify or reuse elsewhere. The script created could be domain specific (i.e. TSQL) or a PowerShell script. This is very useful when you have objects that have properties configured by multiple commands. This is true even if you can get the object from PowerShell and it shows the additional properties. Just because you might be able to see all the properties, it doesn't mean it includes an easy way to generate a similar object.

Here are 3 examples:

--------------

First, a Windows share, in order to recreate it you need a number of properties that were probably created seperately. You have the actual share properties (ShareName, FileSystem Path, caching...), the share permissions (who has access to the share), and finally the NTFS permissions (who has access to the underlying file system). Even if you have one command that had parameters for all of those, you would still want to be able to generate a script to recreate an existing share.

Script-Share -Name "Installs" -ComputerName MyServer -IncludeNTFSPermissions -IncludeSharePermissions

Alternatives for Windows Share:

Get-ShareScript -Name "Installs" -ComputerName MyServer -IncludeNTFSPermissions -IncludeSharePermissions

Backup-Share -Name "Installs" -ComputerName MyServer -IncludeNTFSPermissions -IncludeSharePermissions -ScriptOnly

Export-Share -Name "Installs" -ComputerName MyServer -IncludeNTFSPermissions -IncludeSharePermissions -AsScript

--------------

Second, a SQL Server database. You might want to generate a script that includes the definition of tables, views, stored procedures, database creation, users logins... Doing so by seeing the current properties is very dificult to say the least.

Script-SQLDatabase -ServerInstance DBSERVER1 -Database Commerce -IncludeObjects 'Tables','Views','Stored Procedures','Permissions' -IncludeUseDatabase

Alternatives for SQL:

Get-SQLDatabaseScript -ServerInstance DBSERVER1 -Database Commerce -IncludeObjects 'Tables','Views','Stored Procedures','Permissions' -IncludeUseDatabase

Backup-SQLDatabase -ServerInstance DBSERVER1 -Database Commerce -IncludeObjects 'Tables','Views','Stored Procedures','Permissions' -IncludeUseDatabase -ScriptOnly

Export-SQLDatabase -ServerInstance DBSERVER1 -Database Commerce -IncludeObjects 'Tables','Views','Stored Procedures','Permissions' -IncludeUseDatabase -ScriptSchemaOnly

--------------

And finally, a Windows Service. There are already 8 cmdlets to work with services including New-Service and Get-Service. If you want a PowerShell script to recreate an existing service none of the existing ones can do it. You would want it to give you a New-Service cmdlet with the correct parameters in order to recreate the service.

Script-Service -Name MyService

Alternatives for Service:

Get-ServiceScript -Name MyService

Backup-Service -Name MyService -ScriptOnly

Export-Service -Name MyService -AsScript

--------------

The downside to using alternative verbs is that you need to use additional references in either the Noun or in parameters to make it clear that it will return a script. If you have a cmdlet that only returns a script, it almost requires you to change the Noun in order for it to be understandable. But, if you do that it will no longer be able to get all commands related to that Noun as easily.

Thanks for all the greate work you've done with PowerShell so far.

PowerShell verbs

Richard Siddaway's blog (external) — Mon, 27 Apr 2009 20:17:00 GMT

If you haven't seen the post on PowerShell standard verbs from the PowerShell team it is worth reading

PowerShell verbs

Richard Siddaway's Blog — Mon, 27 Apr 2009 20:01:37 GMT

If you haven't seen the post on PowerShell standard verbs from the PowerShell team it is worth reading

re: Soliciting New Verbs

Bernd Kriszio — Sat, 25 Apr 2009 13:57:44 GMT

In any case it is very good that Microsoft Germany doesn't translate these verbs. The translation of verbose to 'AUSFÜHRLICH' in Write-Verbose output is bad enough (to be precise it is a bug and it happens in PowerShell).

Generally the internationalization of process names and performance counters is was one of the worst decisions Microsoft did.

Please spend the fools who caused this a holiday in Purgatory where they can meet the inventors of a infamous basic version using german keywords.

re: Soliciting New Verbs

seaJhawk — Fri, 24 Apr 2009 22:13:05 GMT

The verb I use all the time is "Check". While in v1 check-* cmdlets were renamed to test-*, these two verbs have an important differenct.

Test implies an action like a synthetic transaction where you provide some input and verify the output. Check, on the other hand, is more passive where you are just peeking in to see how something is doing.

Moving out of the technology arena allows me to provide a great example. If I want to know whether my baby is sleeping or not, I don't "test" the baby, rather I "check" the baby.

The same really applies to things like configuration or services. If I want to know whether or not a service is running, test doesn't fit, but check does (regardless of what the Test-ServiceHealth cmdlet in Exchange is called.) The same goes for verifying that something is configured properly, I really want to just check the current state - not test it.

Verb name: Check

Description: To determine if an entity is in a particular state

Category: Diagnostic

List of at least 5 significantly different applicable domains: Services, file, account, mailbox, queue, configuration, DNS

List of at least 3 alternative verbs from the approved list: Test, Ping, Measure

Pair with: NA

-Chris

re: Soliciting New Verbs

Shane Powser — Fri, 24 Apr 2009 06:48:40 GMT

It seems we have Start/Stop/Restart

What about Connect/Disconnect/Reconnect?