about_ActivityCommonParameters

Aplica-se a: Windows PowerShell 3.0

TÓPICO

about_ActivityCommonParameters

DESCRIÇÃO BREVE

Descreve os parâmetros que Windows PowerShell®Workflow adiciona às atividades.

DESCRIÇÃO LONGA

Windows PowerShell Fluxo de trabalho adiciona parâmetros comuns de atividade a atividades que derivam da classe base PSActivity. Essa categoria inclui a atividade InlineScript e Windows PowerShell cmdlets que são implementados como atividades, como Get-Process e Get-WinEvent.

Os parâmetros comuns de atividade não são válidos nas atividades Suspend-Workflow e Checkpoint-Workflow e eles não são adicionados ao cmdlets ou expressões que Windows PowerShell o fluxo de trabalho executa automaticamente em um bloco de script InlineScript ou atividade semelhante. Os parâmetros comuns de atividade estão disponíveis na atividade InlineScript, mas não em comandos no bloco de script do InlineScript.

Vários dos parâmetros comuns de atividade também são parâmetros comuns de fluxo de trabalho ou Windows PowerShell parâmetros comuns. Outros parâmetros comuns de atividade são exclusivos para atividades.

Para obter informações sobre os parâmetros comuns de fluxo de trabalho, consulte about_WorkflowCommonParameters. Para obter informações sobre os Windows PowerShell parâmetros comuns, consulte about_CommonParameters.

LISTA DE PARÂMETROS COMUNS DE ATIVIDADE

    AppendOutput                      PSDebug
    Debug                             PSDisableSerialization
    DisplayName                       PSError
    ErrorAction                       PSPersist
    Input                             PSPort
    MergeErrorToOutput                PSProgress
    PSActionRetryCount                PSProgressMessage
    PSActionRetryIntervalSec          PSRemotingBehavior    
    PSActionRunningTimeoutSec         PSRequiredModules
    PSApplicationName                 PSSessionOption
    PSAuthentication                  PSUseSSL
    PSCertificateThumbprint           PSVerbose
    PSComputerName                    PSWarning
    PSConfigurationName               Result
    PSConnectionRetryCount            UseDefaultInput
    PSConnectionRetryIntervalSec      Verbose
    PSConnectionURI                   WarningAction
    PSCredential

DESCRIÇÕES DE PARÂMETRO

Esta seção descreve os parâmetros comuns de atividade.

-Appendoutput <Boolean>

Um valor de $True adiciona a saída da atividade ao valor da variável. Um valor de $False não tem nenhum efeito. Por padrão, atribuindo um valor a uma variável substitui o valor da variável.

Por exemplo, os seguintes comandos adicionam um objeto de processo ao objeto de serviço na variável $x.

            workflow Test-Workflow 
            { 
                $x = Get-Service
                $x = Get-Process -AppendOutput $true 
            } 

Esse parâmetro foi projetado para fluxos de trabalho baseados em XAML. Em fluxos de trabalho de script, você também pode usar o operador de atribuição + = para adicionar a saída para o valor de uma variável, conforme mostrado no exemplo a seguir.

            workflow Test-Workflow 
            { 
                $x = Get-Service
                $x += Get-Process
            }

-Debug <SwitchParameter>

Exibe detalhes do programador sobre a operação executada pelo comando. O parâmetro de depuração substitui o valor da variável $DebugPreference para o comando atual. Esse parâmetro só funciona quando o comando gera mensagens de depuração. Esse parâmetro é também um Windows PowerShell parâmetro comum.

-DisplayName <String>

Especifica um nome amigável para a atividade. O valor DisplayName aparece na barra de progresso enquanto o fluxo de trabalho é executado e o valor da propriedade progresso do fluxo de trabalho. Quando o parâmetro PSProgressMessage também está incluído no comando, o conteúdo da barra de progresso é exibido em formato <DisplayName>:<PSProgressMessage>.

-ErrorAction <ActionPreference>

Determina como a atividade responde a um erro de não finalização do comando. Ele não tem nenhum efeito de finalização. Esse parâmetro só funciona quando o comando gera um erro de não finalização, como aqueles do cmdlet Write-Error. O parâmetro ErrorAction substitui o valor da variável $ErrorActionPreference para o comando atual. Esse parâmetro é também um Windows PowerShell parâmetro comum.

VALORES VÁLIDOS:

Continue. Exibe a mensagem de erro e continua executando o comando. "Continue" é o valor padrão.

Ignore. Suprime a mensagem de erro e continua executando o comando. Diferentemente de SilentlyContinue, Ignore não adiciona a mensagem de erro à variável automática $Error. O valor Ignore é apresentado no Windows PowerShell 3.0.

Inquire. Exibe a mensagem de erro e solicita sua confirmação antes de continuar a execução. Esse valor é raramente usado.

Suspend. Suspende automaticamente um trabalho de fluxo de trabalho para permitir uma investigação mais detalhada. Após a investigação, o fluxo de trabalho poderá ser retomado.

SilentlyContinue. Suprime a mensagem de erro e continua executando o comando.

Stop. Exibe a mensagem de erro e interrompe a execução do comando.

-Input <Object[]>

Envia uma coleção de objetos a uma atividade. Essa é uma alternativa aos objetos de pipe para a atividade de uma por vez.

-MergeErrorToOutput <Boolean>

Um valor de $True adiciona erros no fluxo de saída. Um valor de $False não tem efeito. Use este parâmetro com as palavras-chave Parallel e ForEach-Parallel para coletar erros e de saída de vários comandos paralelos em uma única coleção.

-PSActionRetryCount <Int32>

Tenta repetidamente executar a atividade, caso a primeira tentativa falhe. O valor padrão, 0, não tente novamente.

-PSActionRetryIntervalSec <Int32>

Determina o intervalo entre as tentativas de ação em segundos. O valor padrão, 0, repete a ação imediatamente. Este parâmetro é válido somente quando o parâmetro PSActionRetryCount também é usado no comando.

-PSActionRunningTimeoutSec <Int32>

Determina quanto tempo a atividade pode ser executada em cada computador de destino. Se a atividade não for concluída antes do tempo limite expirar, Windows PowerShell interrompe o processamento do fluxo de trabalho no computador de destino afetados e gera um erro de terminação de fluxo de trabalho.

-PSAllowRedirection <Boolean>

Um valor de $True permite o redirecionamento da conexão para os computadores de destino. Um valor de $False não tem nenhum efeito. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Quando você usa o parâmetro PSConnectionURI, o destino remoto pode retornar uma instrução para redirecionar para um URI diferente. Por padrão, Windows PowerShell, não redireciona conexões, mas você pode usar o parâmetro PSAllowRedirection com um valor de $True para permitir o redirecionamento da conexão para o computador de destino.

Você também pode limitar o número de vezes que a conexão é redirecionada, definindo a propriedade MaximumConnectionRedirectionCount da variável preferência $PSSessionOption ou a propriedade MaximumConnectionRedirectionCount do valor do parâmetro SSessionOption de cmdlets que criar uma sessão. O valor padrão é 5.

-PSApplicationName <String>

Especifica o segmento de nome de aplicativo da conexão URI que é usado para conectar-se aos computadores de destino. Use esse parâmetro para especificar o nome do aplicativo quando você não estiver usando o parâmetro ConnectionURI no comando. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

O valor padrão é o valor da variável de preferência $PSSessionApplicationName no computador de destino. Se essa variável de preferência não estiver definida, o valor padrão é WSMAN. Esse valor é adequado para a maioria dos usos. Para obter mais informações, consulte about_Preference_Variables (https://go.microsoft.com/fwlink/?LinkID=113248).

O serviço WinRM usa o nome do aplicativo para selecionar um ouvinte para atender à solicitação de conexão. O valor desse parâmetro deve corresponder ao valor da propriedade URLPrefix de um ouvinte no computador remoto.

-PSAuthentication <AuthenticationMechanism>

Especifica o mecanismo usado para autenticar as credenciais do usuário ao se conectar aos computadores de destino. Os valores válidos são padrão, Basic, Credssp, Digest, Kerberos, Negotiate e NegotiateWithImplicitCredential. O valor padrão é Default. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Para obter informações sobre os valores desse parâmetro, consulte a descrição da enumeração System.Management.Automation.Runspaces.AuthenticationMechanism no MSDN.

CUIDADO: A autenticação de segurança de credencial de Provedor de Serviços (CredSSP), na qual as credenciais do usuário são passadas para um computador remoto para serem autenticadas, foi projetada para comandos que exijam autenticação em mais de um recurso, como acessar um compartilhamento de rede remota. Esse mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais passadas a ele poderão ser usadas para controlar a sessão de rede.

-PSCertificateThumbprint <String>

Especifica o certificado de chave pública digital (X509) de uma conta de usuário com permissão para executar essa ação. Insira a impressão digital do certificado. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Os certificados são utilizados na autenticação baseada em certificado do cliente. Eles podem ser mapeados somente para contas locais de usuário; eles não funcionam com contas de domínio.

Para obter um certificado, use o Get-Item (https://go.microsoft.com/fwlink/?LinkID=113319) ou os cmdlets Get-ChildItem (https://go.microsoft.com/fwlink/?LinkID=113308) no Windows PowerShell Cert: unidade.

-PSComputerName <String[]>

Especifica os computadores de destino em que a atividade é executada. O padrão é o computador local. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Digite o nome NETBIOS, o endereço IP ou o nome de domínio totalmente qualificado de um ou mais computadores em uma lista separada por vírgulas. Para especificar o computador local, digite o nome do computador, um ponto (.) ou então "localhost".

Para incluir o computador local no valor do parâmetro PSComputerName, abra Windows PowerShell com a opção "Executar como administrador".

Se esse parâmetro for omitido do comando, ou se seu valor for $null ou uma cadeia de caracteres vazia, o destino do fluxo de trabalho será o computador local e a comunicação remota do Windows PowerShell não será usada para executar o comando.

Para usar um endereço IP no valor do parâmetro ComputerName, o comando deve incluir o parâmetro PSCredential. Além disso, o computador deve ser configurado para o transporte HTTPS ou o endereço IP do computador remoto deve ser incluído na lista WinRM TrustedHosts no computador local. Para obter instruções sobre como adicionar um nome de computador à lista TrustedHosts, consulte "Como adicionar um computador aoTrusted HostList" em about_Remote_Troubleshooting (https://go.microsoft.com/fwlink/?LinkID=135188).

-PSConfigurationName <String>

Especifica as configurações de sessão que são usadas para criar sessões nos computadores de destino. Digite o nome de uma configuração de sessão nos computadores de destino (e não no computador que está executando o fluxo de trabalho. O padrão é Microsoft.PowerShell. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

-PSConnectionRetryCount <UInt>

Especifica o número máximo de tentativas de conexão para cada computador de destino se a primeira tentativa de conexão falhar. Digite um número entre 1 e 4.294.967.295 (UInt.MaxValue). O valor padrão, zero (0), não representa nenhuma tentativa de repetição. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

-PSConnectionRetryIntervalSec <UInt>

Especifica o atraso entre tentativas de conexão em segundos. O valor padrão é zero (0). Este parâmetro é válido somente quando o valor de PSConnectionRetryCount é pelo menos 1. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

-PSConnectionURI <System.Uri>

Especifica um URI (Uniform Resource Identifier) que define o ponto de extremidade da conexão no computador de destino. O URI deve ser totalmente qualificado. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

O formato dessa cadeia de caracteres é o seguinte:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

O valor padrão é https://localhost:5985/wsman.

Se você não especificar um PSConnectionURI, pode usar os parâmetros PSUseSSL, PSComputerName, PSPort e PSApplicationName para especificar os valores de PSConnectionURI.

Os valores válidos para o segmento de transporte do URI são HTTP e HTTPS. Se você especificar uma conexão URI com um segmento de transporte, mas não especificar uma porta, a sessão é criada com portas de padrões: 80 para HTTP e 443 para HTTPS. Para usar as portas padrão para a comunicação remota do Windows PowerShell, especifique a porta 5985 para HTTP ou 5986 para HTTPS.

-PSCredential <PSCredential>

Especifica uma conta de usuário que tenha permissão para executar a atividade no computador de destino. O padrão é o usuário atual. Este parâmetro é válido somente quando o parâmetro PSComputerName é incluído no comando. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Digite um nome de usuário, como "Usuário01" ou "Domínio01 \ usuário01", ou insira uma variável que contenha um objeto PSCredential, por exemplo, um que o cmdlet Get-Credential retorna. Se você digitar apenas um nome de usuário, uma senha será solicitada.

-PSDebug <PSDataCollection[DebugRecord]>

Adiciona mensagens de depuração da atividade na coleção de registro de depuração especificado, em vez de gravar as mensagens de depuração para o console ou o valor da propriedade de depuração do fluxo de trabalho. Você pode adicionar mensagens de depuração de várias atividades ao mesmo objeto de coleção registro de depuração.

Para usar esse parâmetro comum de atividade, use o cmdlet New-Object para criar um objeto PSDataCollection com um tipo de DebugRecord e salvar o objeto em uma variável. Em seguida, use a variável como o valor do parâmetro PSDebug de uma ou mais atividades, conforme mostrado no exemplo a seguir.

fluxo de trabalho de teste de fluxo de trabalho

            {    
                $debugCollection = New-Object -Type System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
                InlineScript {\\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
                InlineScript {\\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
                if ($debugCollection -like "*Missing*") { ...}
            } 

-PSDisableSerialization <Boolean>

Direciona a atividade para retornar objetos (não serializados) "ativos" para o fluxo de trabalho. Os objetos resultantes têm métodos, bem como propriedades, mas não podem ser salvos quando um ponto de verificação é executado.

-PSDisableSerializationPreference <Boolean>

Aplica o equivalente do parâmetro PSDisableSerialization ao fluxo de trabalho inteiro, não apenas a atividade. A adição deste parâmetro geralmente não é recomendado, porque um fluxo de trabalho que não serializa seus objetos não pode ser retomado ou persistente.

Valores válidos:

-(Padrão) se omitido e você também não adicionou o parâmetro PSDisableSerialization a uma atividade, os objetos são serializados.

-- $True. Dirige todas as atividades em um fluxo de trabalho para retornar objetos (não serializados) "ativos". Os objetos resultantes têm métodos, bem como propriedades, mas não podem ser salvos quando um ponto de verificação é executado.

-- $False. Objetos de fluxo de trabalho são serializados.

-PSError <PSDataCollection[ErrorRecord]>

Adiciona as mensagens de erro da atividade na coleção de registro de erro especificada, em vez de gravar as mensagens de erro no console ou no valor da propriedade de erro do fluxo de trabalho. Você pode adicionar mensagens de erro de várias atividades ao mesmo objeto de conjunto de registros de erro.

Para usar esse parâmetro comum de atividade, use o cmdlet New-Object para criar um objeto PSDataCollection com um tipo de ErrorRecord e salvar o objeto em uma variável. Em seguida, use a variável como o valor do parâmetro PSError de uma ou mais atividades, conforme mostrado no exemplo a seguir.

fluxo de trabalho de teste de fluxo de trabalho

            {    
                 $errorCollection = New-Object -Type System.Management.Automation.PSDataCollection[System.Management.Automation.ErrorRecord]
                 InlineScript {\\Server01\Share01\Get-AssetData.ps1} -PSError $errorCollection
                 InlineScript {\\Server01\Share01\Set-AssetData.ps1} -PSError $errorCollection
                 if ($errorCollection.Count -gt 2) { ...}
            } 

-PSPersist <Boolean>

Usa um ponto de verificação após a atividade. Esse ponto de verificação é uma adição a quaisquer pontos de verificação são especificados no fluxo de trabalho. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Um "ponto de verificação" ou "ponto de persistência" é um snapshot do estado do fluxo de trabalho e dados capturados durante a execução de fluxo de trabalho e é salvo para um armazenamento de persistência em um disco ou banco de dados. Windows PowerShell O fluxo de trabalho usa os dados salvos para retomar um fluxo de trabalho suspenso ou interrompido a partir do último ponto de persistência, em vez de reiniciar o fluxo de trabalho.

Valores válidos:

-- (Padrão) se você omitir esse parâmetro, nenhum ponto de verificação é adicionado. Pontos de verificação são usados com base nas configurações de fluxo de trabalho.

-- $True. Usa um ponto de verificação após a conclusão da atividade. Esse ponto de verificação é uma adição a quaisquer pontos de verificação que são especificados no fluxo de trabalho.

-- $False. Nenhum ponto de verificação é adicionado. Pontos de verificação são executados somente quando especificados no fluxo de trabalho.

-PSPort <Int32>

Especifica a porta de rede nos computadores de destino. As portas padrão são 5985 (a porta de WinRM para HTTP) e 5986 (a porta de WinRM para HTTPS). Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Não use o parâmetro PSPort, a menos que você precise. A porta definida no comando se aplica a todos os computadores ou sessões em que o comando é executado. Uma configuração de porta alternativa pode impedir que o comando seja executado em todos os computadores. Antes de usar uma porta alternativa, você deve configurar o ouvinte do WinRM no computador remoto para escutar naquela porta.

-PSProgress <PSDataCollection[ProgressRecord]>

Adiciona mensagens de andamento da atividade na coleção de registro de progresso especificada, em vez de gravar mensagens de progresso para o console ou o valor da propriedade Progresso do fluxo de trabalho. Você pode adicionar mensagens de andamento de várias atividades para o mesmo objeto de conjunto de registros de progresso.

-PSProgressMessage <String>

Especifica uma descrição amigável da atividade. O valor de PSProgressMessage aparece na barra de progresso enquanto o fluxo de trabalho é executado. Quando o DisplayName também está incluído no comando, o conteúdo da barra de progresso é exibido em <DisplayName>:<PSProgressMessage> format.

Esse parâmetro é particularmente útil para identificar atividades em um bloco de script ForEach-Parallel. Sem essa mensagem, as atividades em todas as ramificações paralelas são identificadas pelo mesmo nome.

-PSRemotingBehavior <RemotingBehavior>

Especifica como a comunicação remota é gerenciada quando a atividade é executada em computadores de destino. PowerShell é o padrão.

Os valores válidos são:

Nenhum: A atividade não é executada em computadores remotos.

PowerShell: A comunicação remota do Windows PowerShell é usada para executar a atividade em computadores de destino.

Personalizado: A atividade dá suporte a seu próprio tipo de comunicação remota. Esse valor é válido quando o cmdlet que está sendo implementado como uma atividade define o valor do atributo RemotingCapability SupportedByCommand e o comando inclui o parâmetro ComputerName.

-PSRequiredModules <String[]>

Importa os módulos especificados antes de executar o comando. Insira os nomes do módulo. Os módulos devem ser instalados no computador de destino.

Módulos que são instalados em um caminho especificado na variável de ambiente PSModulePath são importados automaticamente no primeiro uso de todos os comandos no módulo. Use esse parâmetro para importar os módulos que não estão em um local de PSModulePath.

Como cada atividade em um fluxo de trabalho é executada em sua própria sessão, um comando Import-Module importa um módulo somente para a sessão na qual ele é executado. Não importa o módulo para sessões em que executam outras atividades.

-PSSessionOption <PSSessionOption>

Define opções avançadas para as sessões nos computadores de destino. Insira um objeto PSSessionOption, por exemplo, um que você cria usando o cmdlet New-PSSessionOption. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

Os valores padrão para as opções da sessão são determinados pelo valor da variável de preferência $PSSessionOption, se definido. Caso contrário, a sessão usa os valores especificados na configuração da sessão.

Para obter uma descrição das opções de sessão, incluindo os valores padrão, consulte o tópico de ajuda para o cmdlet New-PSSessionOption (https://go.microsoft.com/fwlink/?LinkID=144305).

Para obter mais informações sobre a variável de preferência $PSSessionOption, consulte about_Preference_Variables (https://go.microsoft.com/fwlink/?LinkID=113248).

-PSUseSSL <Boolean>

Um valor de $True usa o protocolo Secure Sockets Layer (SSL) para estabelecer uma conexão com o computador de destino. Por padrão, SSL não é usado. Um valor de $False não tem nenhum efeito. Esse parâmetro comum de atividade também é um parâmetro comum de fluxo de trabalho.

WS-Management criptografa todo o conteúdo do Windows PowerShell transmitido pela rede. UseSSL é uma proteção adicional que envia os dados em um HTTPS, em vez de HTTP. Se você usar esse parâmetro, mas o SSL não estiver disponível na porta usada para o comando, o comando falhará.

-PSVerbose <PSDataCollection[VerboseRecord]>

Adiciona mensagens detalhadas da atividade na coleção de registro detalhado especificado, em vez de escrever as mensagens detalhadas no console ou no valor da propriedade detalhada do fluxo de trabalho. Você pode adicionar mensagens detalhadas de várias atividades ao mesmo objeto de coleção de registro detalhado.

-PSWarning <PSDataCollection[WarningRecord]>

Adiciona as mensagens de aviso da atividade na coleção especificada de registro do aviso, em vez de gravar as mensagens de aviso no console ou no valor da propriedade aviso do fluxo de trabalho. Você pode adicionar mensagens de aviso de várias atividades ao mesmo objeto de conjunto de registros de aviso.

-RESULTADOS

Esse parâmetro só é válido em fluxos de trabalho XAML.

-UseDefaultInput <Boolean>

Aceita todas as entradas de fluxo de trabalho como entrada para a atividade por valor.

Por exemplo, a atividade de Get-Process no fluxo de trabalho de exemplo seguinte usa o parâmetro comum de atividade UseDefaultInput para obter a entrada que é passada para o fluxo de trabalho. Quando você executa o fluxo de trabalho com a entrada, essa entrada é usada pela atividade.

            workflow Test-Workflow 
            {
                Get-Service -UseDefaultInput $True
            }

            PS C:\>Test-Workflow -InputObject WinRm

            Status   Name               DisplayName                            PSComputerName
            ------   ----               -----------                            --------------
            Running  winrm              Windows Remote Management (WS-Manag... localhost

-Verbose <SwitchParameter>

Exibe informações detalhadas sobre a operação executada pelo comando. Essas informações se parecem com as informações em um rastreamento ou em um log de transações. O parâmetro Verbose substitui o valor da variável $VerbosePreference para o comando atual. Esse parâmetro só funciona quando o comando gera uma mensagem detalhada. Esse parâmetro é também um Windows PowerShell parâmetro comum.

-WarningAction <ActionPreference>

Determina como a atividade responde a um aviso. "Continue" é o valor padrão. O parâmetro WarningAction substitui o valor da variável $WarningPreference para o comando atual. Esse parâmetro só funciona quando o comando gera uma mensagem de aviso. Esse parâmetro é também um Windows PowerShell parâmetro comum.

Valores válidos:

SilentlyContinue. Suprime a mensagem de aviso e continua executando o comando.

Continue. Exibe a mensagem de aviso e continua executando o comando. "Continue" é o valor padrão.

Inquire. Exibe a mensagem de aviso e solicita sua confirmação antes de continuar a execução. Esse valor é raramente usado.

Stop. Exibe a mensagem de aviso e interrompe a execução do comando.

OBSERVAÇÃO: O parâmetro WarningAction não substitui o valor da variável de preferência $WarningAction quando o parâmetro é usado em um comando para executar um script ou uma função.

EXEMPLOS

Os parâmetros comuns de atividade são extremamente úteis. Por exemplo, você pode usar o parâmetro PSComputerName para executar atividades específicas em apenas um subconjunto dos computadores de destino.

Ou, você pode usar os parâmetros PSConnectionRetryCount e PSConnectionRetryIntervalSec para ajustar os valores de repetição para atividades específicas.

O exemplo a seguir mostra como usar os parâmetros comuns de atividade PSComputerName para executar uma atividade de Get-EventLog apenas em computadores que têm um domínio específico.

        {
             $UserDomain = Get-Content -Path .\UserComputers.txt
             $Log = (Get-EventLog -LogName "Windows PowerShell" -PSComputerName $UserDomain}
             if ($Log) ...
        } 

PALAVRAS-CHAVE

about_Activity_Common_Parameters

about_Activity_Parameters

about_ActivityParameters

CONSULTE TAMBÉM

about_Workflows

about_WorkflowCommonParameters