Partilhar via


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 , como um que o cmdlet Get-Credential retorna, para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite "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.