Get-SCOMTask
Obtém uma lista de tarefas.
Sintaxe
Empty (Predefinição)
Get-SCOMTask
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromTaskDisplayName
Get-SCOMTask
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromTaskId
Get-SCOMTask
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromInstance
Get-SCOMTask
[-Instance] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPack
Get-SCOMTask
[-ManagementPack] <ManagementPack[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromTaskName
Get-SCOMTask
[-Name <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPackClass
Get-SCOMTask
[-Target <ManagementPackClass[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
O cmdlet Get-SCOMTask obtém uma lista de tarefas. Use este cmdlet para obter tarefas que tenham um nome ou ID específico, bem como tarefas associadas a funções de usuário especificadas, instâncias de classe, pacotes de gerenciamento ou classes de destino.
Exemplos
Exemplo 1: Obter tarefas especificando um nome parcial
PS C:\>Get-SCOMTask -Name "*health*"
Este comando obtém todas as tarefas que têm saúde em seus nomes.
Exemplo 2: Obter uma tarefa usando um nome de exibição parcial
PS C:\>Get-SCOMTask -DisplayName "Stop*"
Este comando obtém todas as tarefas com nomes de exibição que começam com Parar.
Exemplo 3: Obter uma tarefa especificando um nome de exibição parcial e uma ação de erro
PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue
Este comando obtém todas as tarefas para os pacotes de gerenciamento que têm o System Center Core em seus nomes de exibição. O comando usa o cmdlet Get-SCOMManagementPack para obter pacotes de gerenciamento com base em nomes de exibição e os passa para o cmdlet Get-SCOMTask. Como o comando especifica SilentlyContinue para o parâmetro ErrorAction, se o cmdlet encontrar um pacote de gerenciamento sem tarefas associadas, ele continuará a ser executado e não exibirá mensagens de erro.
Exemplo 4: Obter tarefas usando um nome de classe parcial
PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask
Este comando obtém todas as tarefas para classes que têm integridade em seus nomes.
Exemplo 5: Obter tarefas especificando um nome de instância de classe parcial
PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask
Este comando obtém todas as tarefas para instâncias de classe que têm .Contoso.com em seus nomes.
Exemplo 6: Obter uma tarefa especificando um ID
PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd
Este comando obtém a tarefa que tem um ID de 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.
Parâmetros
-ComputerName
Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).
O computador deve executar o serviço de Acesso a Dados do System Center.
Se você não especificar esse parâmetro, o padrão será o computador para a conexão atual do grupo de gerenciamento.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Especifica a conta de usuário sob a qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto PSCredential Get-Help Get-Credential".
Essa conta deve ter acesso ao servidor especificado no parâmetro ComputerName se esse parâmetro for exibido.
Se você não especificar esse parâmetro, o padrão será a conta do usuário atual.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-DisplayName
Especifica uma matriz de nomes de exibição para objetos de tarefa. Esse parâmetro usa uma ou mais cadeias de caracteres e o cmdlet procura correspondências entre os nomes de exibição dos objetos de tarefa com os quais o cmdlet trabalha. Os valores para esse parâmetro variam dependendo de quais pacotes de gerenciamento localizados são importados para o grupo de gerenciamento e da localidade do usuário que executa o Windows PowerShell.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTaskDisplayName
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica uma matriz de IDs de tarefa. O cmdlet obtém as tarefas que têm essas IDs. Para obter uma tarefa, use o cmdlet Get-SCOMTask. A ID é a ID propriedade de um objeto de tarefa.
Propriedades dos parâmetros
| Tipo: | Guid[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTaskId
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Instance
Especifica uma matriz de EnterpriseManagementObject objetos que representam instâncias de classe. O cmdlet recupera tarefas para as instâncias de classe que a matriz armazena. Especifique uma variável que represente as instâncias de classe ou use um cmdlet como Get-SCOMClassInstance que obtém as instâncias de classe. Este parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup.
Propriedades dos parâmetros
| Tipo: | EnterpriseManagementObject[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromInstance
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ManagementPack
Especifica uma matriz de objetos do pacote de gerenciamento. O cmdlet obtém tarefas para os objetos do pacote de gerenciamento na matriz. Especifique uma variável que contenha objetos de pacote de gerenciamento ou use um cmdlet como Get-SCOMManagementPack que obtém objetos de pacote de gerenciamento.
Propriedades dos parâmetros
| Tipo: | ManagementPack[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromManagementPack
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica uma matriz de nomes de tarefas.
O cmdlet usa cada cadeia de caracteres na matriz e faz a correspondência com as propriedades Name dos objetos de tarefa com os quais esse cmdlet trabalha.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromTaskName
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SCSession
Especifica uma matriz de objetos Connection. Para obter objetos Connection, especifique o cmdlet Get-SCOMManagementGroupConnection.
Se esse parâmetro não aparecer, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento.
Use o parâmetro SCSession para especificar uma conexão persistente diferente.
Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential.
Para obter mais informações, digite "Get-Help about_OpsMgr_Connections".
Propriedades dos parâmetros
| Tipo: | Connection[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Target
Especifica uma matriz de objetos de classe do pacote de gerenciamento que representam classes de destino. Especifique uma variável que contenha os objetos de classe de destino ou use um cmdlet como Get-SCOMClass que obtém os objetos de classe de destino.
Propriedades dos parâmetros
| Tipo: | ManagementPackClass[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromManagementPackClass
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.