Declaração de atributo de credencial

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 da 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 um host personalizado estiver sendo usado que define um prompt diferente, esse prompt será exibido.

• Esse atributo é usado com o atributo Parameter. Para obter mais informações sobre esse atributo, consulte de Declaração de Atributo de Parâmetro.

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

Consulte Também

Aliases de parâmetro

declaração de atributo de parâmetro

gravando um cmdlet do Windows PowerShell