Dichiarazione della classe dei cmdletCmdlet Class Declaration

Una classe Microsoft .NET Framework viene dichiarata come cmdlet specificando l'attributo del cmdlet come metadati per la classe.A Microsoft .NET Framework class is declared as a cmdlet by specifying the Cmdlet attribute as metadata for the class. L'attributo del cmdlet è l'unico attributo obbligatorio per tutti i cmdlet.(The Cmdlet attribute is the only required attribute for all cmdlets). Quando si specifica l'attributo del cmdlet , è necessario specificare la coppia 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. È necessario descrivere la funzionalità di Windows PowerShell supportata dal cmdlet.And, you must describe the Windows PowerShell functionality that the cmdlet supports. Per ulteriori informazioni sulla sintassi di dichiarazione utilizzata per specificare l'attributo cmdlet , vedere Dichiarazione dell' attributo del cmdlet.For more information about the declaration syntax that is used to specify the Cmdlet attribute, see Cmdlet Attribute Declaration.

Nota

L'attributo cmdlet viene definito dalla classe System. Management. Automation. CmdletAttribute .The Cmdlet attribute is defined by the System.Management.Automation.CmdletAttribute class. Le proprietà di questa classe corrispondono ai parametri di dichiarazione usati quando si dichiara l'attributo.The properties of this class correspond to the declaration parameters that are used when you declare the attribute.

SostantiviNouns

Il sostantivo del cmdlet specifica le risorse su cui agisce il cmdlet.The noun of the cmdlet specifies the resources upon which the cmdlet acts. Il sostantivo distingue i cmdlet da altri cmdlet.The noun differentiates your cmdlets from other cmdlets.

I sostantivi nei nomi dei cmdlet devono essere specifici e, nel caso di sostantivi generici, ad esempio Server, è preferibile aggiungere un prefisso breve che differenzi la risorsa 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 il cmdlet mediante la relativa azione e quindi di identificare il cmdlet mediante la relativa risorsa evitando la duplicazione del nome di cmdlet non necessaria.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 possono essere usati nei nomi di cmdlet, vedere le linee guida per lo sviluppo necessarie.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 per lo sviluppo richiedono l'uso di 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. Utilizzando uno di questi verbi predefiniti, sarà garantita la coerenza tra i cmdlet scritti da e i cmdlet scritti da Microsoft e da altri.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. Il verbo "Get", ad esempio, viene usato per i cmdlet che recuperano i dati.For example, the "Get" verb is used for cmdlets that retrieve data.

Per ulteriori 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 possono essere usati nei nomi di cmdlet, vedere le linee guida per lo sviluppo necessarie.For a list of special characters that cannot be used in cmdlet names, see Required Development Guidelines.

Supporto della funzionalità di Windows PowerShellSupporting Windows PowerShell Functionality

L'attributo cmdlet consente inoltre di specificare che il cmdlet supporta alcune delle funzionalità comuni fornite 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. Questo include il supporto per le funzionalità comuni, ad esempio la conferma dei commenti e suggerimenti degli utenti, denominate supporto per la funzionalità ShouldProcess, e il 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. (Il supporto per le transazioni è stato introdotto in Windows PowerShell 2,0).(Support for transactions was introduced in Windows PowerShell 2.0).

Per ulteriori informazioni sulla sintassi di dichiarazione utilizzata per specificare l'attributo cmdlet , vedere Dichiarazione dell' attributo del 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 di una classe di cmdlet GetProc.The following code is the definition for a GetProc cmdlet class. Si noti che viene utilizzata la combinazione di maiuscole e minuscole Pascal e che il nome della classe include il verbo e il sostantivo 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

Maiuscole e minuscole PascalPascal Casing

Quando si denominano i cmdlet, utilizzare la convenzione Pascal.When you name cmdlets, use Pascal casing. I cmdlet e, ad esempio, Get-Item Get-ItemProperty mostrano il modo corretto per usare le maiuscole per la denominazione dei 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 dei verbi dei cmdletCmdlet Verb Names

Scrittura di un cmdlet di Windows PowerShellWriting a Windows PowerShell Cmdlet

Windows PowerShell SDKWindows PowerShell SDK