Parâmetros de Atividades
A tabela que se segue lista os nomes e funcionalidade recomendados para os parâmetros de atividade.
Parâmetro | Funcionalidade |
---|---|
Append Tipo de dados: SwitchParameter |
Implemente este parâmetro para que o utilizador possa adicionar conteúdo ao fim de um recurso quando o parâmetro for especificado. |
CasoSensitivo Tipo de dados: SwitchParameter |
Implemente este parâmetro para que o utilizador possa requerer sensibilidade ao caso quando o parâmetro for especificado. |
Command Tipo de dados: String |
Implemente este parâmetro para que o utilizador possa especificar uma cadeia de comando para executar. |
CompatibilidadeVer Tipo de dados: System.Version objeto |
Implemente este parâmetro para que o utilizador possa especificar a semântica com a qual o cmdlet deve ser compatível com a compatibilidade com as versões anteriores. |
Compress Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que a compressão de dados seja utilizada quando o parâmetro é especificado. |
Compress Tipo de dados: Keyword |
Implemente este parâmetro para que o utilizador possa especificar o algoritmo para usar para a compressão de dados. |
Continuous Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que os dados são tratados até que o utilizador encerre o cmdlet quando o parâmetro for especificado. Se o parâmetro não for especificado, o cmdlet processa uma quantidade de dados predefinida e, em seguida, termina a operação. |
Create Tipo de dados: SwitchParameter |
Implemente este parâmetro para indicar que um recurso é criado se não existir já quando o parâmetro é especificado. |
Delete Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que os recursos sejam eliminados quando o cmdlet tiver concluído o seu funcionamento quando o parâmetro for especificado. |
Drain Tipo de dados: SwitchParameter |
Implemente este parâmetro para indicar que os itens de trabalho pendentes são processados antes que o cmdlet processe novos dados quando o parâmetro é especificado. Se o parâmetro não for especificado, os artigos de trabalho são processados imediatamente. |
Erase Tipo de dados: Int32 |
Implemente este parâmetro para que o utilizador possa especificar o número de vezes que um recurso é apagado antes de ser eliminado. |
ErroLevel Tipo de dados: Int32 |
Implemente este parâmetro para que o utilizador possa especificar o nível de erros a reportar. |
Excluir Tipo de dados: String[] |
Implemente este parâmetro para que o utilizador possa excluir algo de uma atividade. Para obter mais informações sobre como utilizar filtros de entrada, consulte os parâmetros do filtro de entrada. |
Filtro Tipo de dados: Keyword |
Implemente este parâmetro para que o utilizador possa especificar um filtro que selecione os recursos para realizar a ação cmdlet. Para obter mais informações sobre como utilizar filtros de entrada, consulte os parâmetros do filtro de entrada. |
Seguir Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o progresso seja rastreado quando o parâmetro é especificado. |
Force Tipo de dados: SwitchParameter |
Implemente este parâmetro para indicar que o utilizador pode executar uma ação mesmo que sejam encontradas restrições quando o parâmetro é especificado. O parâmetro não permite que a segurança seja comprometida. Por exemplo, este parâmetro permite que um utilizador substitua um ficheiro apenas de leitura. |
Include Tipo de dados: String[] |
Implemente este parâmetro para que o utilizador possa incluir algo numa atividade. Para obter mais informações sobre como utilizar filtros de entrada, consulte os parâmetros do filtro de entrada. |
Incremental Tipo de dados: SwitchParameter |
Implemente este parâmetro para indicar que o processamento é realizado incrementalmente quando o parâmetro é especificado. Por exemplo, este parâmetro permite que um utilizador execute cópias de segurança incrementais que fazem cópias de segurança que fazem backup apenas desde a última cópia de segurança. |
EntradaObject Tipo de dados: Object |
Implemente este parâmetro quando o cmdlet retirar a entrada de outros cmdlets. Quando define um parâmetro de EntradaObject , especifique sempre a palavra-chave ValueFromPipeline quando declarar o atributo Parâmetro . Para obter mais informações sobre a utilização de filtros de entrada, consulte os parâmetros do filtro de entrada. |
Insert Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet insira um item quando o parâmetro é especificado. |
Interativo Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet funcione interativamente com o utilizador quando o parâmetro for especificado. |
Interval Tipo de dados: HashTable |
Implemente este parâmetro para que o utilizador possa especificar uma tabela de hash de palavras-chave que contenha os valores. O exemplo a seguir mostra os valores da amostra para o Interval parâmetro: -interval @{ResumeScan=15; Retry=3} . |
Registo Tipo de dados: SwitchParameter |
Implementar este parâmetro auditar as ações do cmdlet quando o parâmetro for especificado. |
NoClobber Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o recurso não seja substituído quando o parâmetro for especificado. Este parâmetro aplica-se geralmente aos cmdlets que criam novos objetos para que possam ser impedidos de sobrepor os objetos existentes com o mesmo nome. |
Notify Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o utilizador seja notificado de que a atividade está completa quando o parâmetro for especificado. |
NotifyEndereço Tipo de dados: endereço de e-mail |
Implemente este parâmetro para que o utilizador possa especificar o endereço de e-mail para utilizar para enviar uma notificação quando o Notify parâmetro for especificado. |
Overwrite Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet substitua quaisquer dados existentes quando o parâmetro é especificado. |
Prompt Tipo de dados: String |
Implemente este parâmetro para que o utilizador possa especificar uma solicitação para o cmdlet. |
Quiet Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet suprime o feedback do utilizador durante as suas ações quando o parâmetro é especificado. |
Repetir Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet realize novamente as suas ações em recursos quando o parâmetro é especificado. |
Reparação Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet tente corrigir algo de um estado quebrado quando o parâmetro é especificado. |
ReparaçãoString Tipo de dados: String |
Implemente este parâmetro de modo a que o utilizador possa especificar uma corda a utilizar quando o parâmetro de Reparação for especificado. |
Retry Tipo de dados: Int32 |
Implemente este parâmetro para que o utilizador possa especificar o número de vezes que o cmdlet tentará uma ação. |
Select Tipo de dados: Keyword array |
Implemente este parâmetro para que o utilizador possa especificar um array dos tipos de itens. |
Rio Tipo de dados: SwitchParameter |
Implemente este parâmetro para que o utilizador possa transmitir vários objetos de saída através do pipeline quando o parâmetro for especificado. |
Strict Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que todos os erros sejam tratados como erros de terminação quando o parâmetro é especificado. |
Deslocação temporária Tipo de dados: String |
Implemente este parâmetro para que o utilizador possa especificar a localização dos dados temporários utilizados durante o funcionamento do cmdlet. |
Intervalo de tempo Tipo de dados: Int32 |
Implemente este parâmetro de modo a que o utilizador possa especificar o intervalo de tempo limite (em milissegundos). |
Truncate Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet truntará as suas ações quando o parâmetro for especificado. Se o parâmetro não for especificado, o cmdlet executa outra ação. |
Verify Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet teste para determinar se ocorreu uma ação quando o parâmetro é especificado. |
Wait Tipo de dados: SwitchParameter |
Implemente este parâmetro de modo a que o cmdlet aguarde a entrada do utilizador antes de continuar quando o parâmetro for especificado. |
Tempo de Espera Tipo de dados: Int32 |
Implemente este parâmetro de modo a que o utilizador possa especificar a duração (em segundos) de que o cmdlet aguarda a entrada do utilizador quando o parâmetro de espera for especificado. |
Consulte também
Cmdlet Parameters (Parâmetros de Cmdlets)
Writing a Windows PowerShell Cmdlet (Escrever um Cmdlet do Windows PowerShell)
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários