Credential Attribute Declaration (Declaração do Atributo Credential)

O atributo Credential é um atributo opcional que pode ser usado com parâmetros de credencial do tipo System.Management.Automation.PSCredential para que uma cadeia de caracteres também possa ser passada como um argumento para o parâmetro. Quando esse atributo é adicionado a uma declaração de parâmetro, o Windows PowerShell converte a entrada de cadeia de caracteres em um objeto System.Management.Automation.PSCredential. Por exemplo, o cmdlet Get-Credential usa esse atributo para que o Windows PowerShell gere o objeto System.Management.Automation.PSCredential retornado pelo cmdlet.

Sintaxe

[Credential]

Observações

• Normalmente, esse atributo é usado por parâmetros do tipo System.Management.Automation.PSCredential para que uma cadeia de caracteres também possa ser passada como um argumento para o parâmetro. Quando um objeto System.Management.Automation.PSCredential é passado para o parâmetro, o Windows PowerShell não faz nada.

• Ao criar o objeto System.Management.Automation.PSCredential, o Windows PowerShell usa o Host atual para exibir os prompts apropriados para o usuário. Por exemplo, o Host padrão exibe um prompt para um nome de usuário e senha quando esse atributo é usado. No entanto, se estiver sendo usado um host personalizado que defina um prompt diferente, esse prompt será exibido.

• Este atributo é usado com o atributo Parameter. Para obter mais informações sobre esse atributo, consulte Parameter Attribute Declaration.

• O atributo credential é definido pela classe System.Management.Automation.CredentialAttribute.

Ver também

aliases de parâmetro

Declaração de Atributo de Parâmetro

Escrevendo um cmdlet do Windows PowerShell