Dichiarazione della classe dei cmdletCmdlet Class Declaration

Una classe di Microsoft .NET Framework è dichiarata come un cmdlet, specificando il Cmdlet attributo sotto forma di metadati per la classe.A Microsoft .NET Framework class is declared as a cmdlet by specifying the Cmdlet attribute as metadata for the class. (Il Cmdlet attributo è l'unico attributo obbligatorio per tutti i cmdlet).(The Cmdlet attribute is the only required attribute for all cmdlets). Quando si specifica la Cmdlet attributo, è necessario specificare la coppia di verbo e nome che identifica il cmdlet per l'utente.When you specify the Cmdlet attribute, you must specify the verb-and-noun pair that identifies the cmdlet to the user. E, è necessario descrivere le funzionalità di Windows PowerShell che supporta il cmdlet.And, you must describe the Windows PowerShell functionality that the cmdlet supports. Per altre informazioni sulla sintassi di dichiarazione che consente di specificare il Cmdlet dell'attributo, vedere dichiarazione di attributo Cmdlet.For more information about the declaration syntax that is used to specify the Cmdlet attribute, see Cmdlet Attribute Declaration.

Nota

Il Cmdlet dipende dall'attributo le System.Management.Automation.CmdletAttribute classe.The Cmdlet attribute is defined by the System.Management.Automation.CmdletAttribute class. Le proprietà di questa classe corrispondono ai parametri utilizzati quando si dichiara l'attributo di dichiarazione.The properties of this class correspond to the declaration parameters that are used when you declare the attribute.

SostantiviNouns

Il sostantivo del cmdlet consente di specificare le risorse su cui agisce il cmdlet.The noun of the cmdlet specifies the resources upon which the cmdlet acts. Il sostantivo riconosce la differenza dei cmdlet da altri cmdlet.The noun differentiates your cmdlets from other cmdlets.

Sostantivi nei nomi dei cmdlet devono essere specifico e, nel caso di sostantivi generici, ad esempio server, è consigliabile aggiungere un prefisso breve che consentono di distinguere le risorse da altre risorse simili.Nouns in cmdlet names must be specific, and in the case of generic nouns, such as server, it is best to add a short prefix that differentiates your resource from other similar resources. Ad esempio, è un nome di cmdlet che include un sostantivo con un prefisso Get-SQLServer.For example, a cmdlet name that includes a noun with a prefix is Get-SQLServer. La combinazione di un sostantivo specifico con un verbo più generale consente all'utente di individuare rapidamente i cmdlet per la relativa azione e quindi identificando il cmdlet per la propria risorsa evitando la duplicazione del nome cmdlet non necessari.The combination of a specific noun with a more general verb enables the user to quickly locate the cmdlet by its action and then identify the cmdlet by its resource while avoiding unnecessary cmdlet name duplication.

Per un elenco di caratteri speciali che non può essere usato nei nomi di cmdlet, vedere linee guida sullo sviluppo necessari.For a list of special characters that cannot be used in cmdlet names, see Required Development Guidelines.

VerbiVerbs

Quando si specifica un verbo, le linee guida sullo sviluppo richiedono di usare uno dei verbi predefiniti forniti da Windows PowerShell.When you specify a verb, the development guidelines require you to use one of the predefined verbs provided by Windows PowerShell. Usando uno di questi verbi predefiniti, si garantisce la coerenza tra i cmdlet personalizzati e i cmdlet che vengono scritti da Microsoft e da altri utenti.By using one of these predefined verbs, you will ensure consistency between the cmdlets that you write and the cmdlets that are written by Microsoft and by others. Ad esempio, il verbo "Get" viene usato per i cmdlet che recuperano i dati.For example, the "Get" verb is used for cmdlets that retrieve data.

Per altre informazioni sulle linee guida per i verbi, vedere nomi dei verbi di Cmdlet.For more information about guidelines for verbs, see Cmdlet Verb Names. Per un elenco di caratteri speciali che non può essere usato nei nomi di cmdlet, vedere linee guida sullo sviluppo necessari.For a list of special characters that cannot be used in cmdlet names, see Required Development Guidelines.

Supporto di funzionalità di Windows PowerShellSupporting Windows PowerShell Functionality

Il Cmdlet attributo consente inoltre di specificare che il cmdlet supporta alcune delle funzionalità comune fornita da Windows PowerShell.The Cmdlet attribute also allows you to specify that your cmdlet supports some of the common functionality that is provided by Windows PowerShell. Ciò include il supporto per le funzionalità comuni, ad esempio conferma di commenti e suggerimenti utente (detto supporto per la funzionalità di ShouldProcess) e supporto per le transazioni.This includes support for common functionality such as user feedback confirmation (referred to as support for the ShouldProcess feature) and support for transactions. (Supporto delle transazioni è stato introdotto in Windows PowerShell 2.0).(Support for transactions was introduced in Windows PowerShell 2.0).

Per altre informazioni sulla sintassi di dichiarazione che consente di specificare il Cmdlet dell'attributo, vedere dichiarazione di attributo Cmdlet.For more information about the declaration syntax that is used to specify the Cmdlet attribute, see Cmdlet Attribute Declaration.

Definizione della classe cmdletCmdlet Class Definition

Il codice seguente è la definizione per una classe cmdlet GetProc.The following code is the definition for a GetProc cmdlet class. Si noti che la convenzione Pascal maiuscole e minuscole viene utilizzata e che il nome della classe include il verbo e nome del cmdlet.Notice that Pascal casing is used and that the name of the class includes the verb and noun of the cmdlet.

[Cmdlet(VerbsCommon.Get, "Proc")]
public class GetProcCommand : Cmdlet   

La convenzione Pascal maiuscole e minuscolePascal Casing

Quando si assegna un nome cmdlet, utilizzare la convenzione Pascal maiuscole e minuscole.When you name cmdlets, use Pascal casing. Ad esempio, il Get-Item e Get-ItemProperty cmdlet mostrano il modo corretto da utilizzare per l'uso delle maiuscole denominazione cmdlet.For example, the Get-Item and Get-ItemProperty cmdlets show the correct way to use capitalization when you are naming cmdlets.

Vedere ancheSee Also

System.Management.Automation.CmdletAttributeSystem.Management.Automation.CmdletAttribute

Dichiarazione CmdletAttributeCmdletAttribute Declaration

Nomi di verbi di cmdletCmdlet Verb Names

Scrittura di un cmdlet di Windows PowerShellWriting a Windows PowerShell Cmdlet

Windows PowerShell SDKWindows PowerShell SDK