Condividi tramite


Alias dei parametri

I parametri dei cmdlet possono anche avere alias. È possibile usare gli alias anziché i nomi dei parametri quando si digita o si specifica il parametro in un comando.

Vantaggi dell'uso di alias

L'aggiunta di alias ai parametri offre i vantaggi seguenti.

  • È possibile fornire un collegamento in modo che l'utente non deve usare il nome completo del parametro quando viene chiamato il cmdlet. Ad esempio, è possibile usare l'alias "CN" anziché il nome del parametro "ComputerName".

  • È possibile definire più alias se si desidera specificare nomi diversi per lo stesso parametro. È possibile definire più alias se è necessario usare più gruppi di utenti che fanno riferimento agli stessi dati in modi diversi.

  • È possibile fornire la compatibilità con le versioni precedenti per gli script esistenti se il nome di un parametro cambia.

  • Usando l'attributo Alias insieme all'attributo ValueFromPipelineByName, è possibile definire un parametro che consenta al cmdlet di eseguire l'associazione a tipi di oggetto diversi. Si supponga, ad esempio, di avere due oggetti di tipi diversi e che il primo oggetto avesse una proprietà writer e che il secondo oggetto avesse una proprietà dell'editor. Se il cmdlet aveva un parametro con alias di writer e editor e il cmdlet accettava l'input della pipeline in base ai nomi delle proprietà, il cmdlet potrebbe eseguire l'associazione a entrambi gli oggetti usando i due alias di parametro.

Per altre informazioni sugli alias che possono essere usati con parametri specifici, vedere Nomi di parametri comuni.

Definizione di alias di parametro

Per definire un alias per un parametro, dichiarare l'attributo Alias, come illustrato nella dichiarazione di parametro seguente. In questo esempio vengono definiti più alias per lo stesso parametro. Per altre informazioni, vedereCome dichiarare i parametri dei cmdlet.

[Alias("UN","Writer","Editor")]
[Parameter()]
public string UserName
{
  get { return userName; }
  set { userName = value; }
}
private string userName;

Vedere anche

Nomi dei parametri comuni

Come dichiarare i parametri dei cmdlet

Scrittura di un cmdlet di Windows PowerShell