Compartilhar via


Get-SCOMTask

Obtém uma lista de tarefas.

Sintaxe

Empty (Padrã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 esse 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*"

Esse comando obtém todas as tarefas que têm integridade em seus nomes.

Exemplo 2: Obter uma tarefa usando um nome de exibição parcial

PS C:\>Get-SCOMTask -DisplayName "Stop*"

Esse comando obtém todas as tarefas que têm nomes de exibição que começam com Stop.

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

Esse 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 do . Como o comando especifica SilentlyContinue para o parâmetro ErrorAction, se o cmdlet encontrar um pacote de gerenciamento sem tarefas associadas, ele continuará sendo 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

Esse 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

Esse 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 uma ID

PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Esse comando obtém a tarefa que tem uma 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 do grupo de gerenciamento atual.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Credential

Especifica a conta de usuário na 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 do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 funciona. Os valores desse parâmetro variam dependendo de quais pacotes de gerenciamento localizados são importados para o grupo de gerenciamento e a localidade do usuário que executa o Windows PowerShell.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromTaskDisplayName
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 propriedade de ID de de um objeto de tarefa.

Propriedades do parâmetro

Tipo:

Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromTaskId
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Instance

Especifica uma matriz de objetos EnterpriseManagementObject 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. Esse parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup.

Propriedades do parâmetro

Tipo:

EnterpriseManagementObject[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromInstance
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do pacote de gerenciamento ou use um cmdlet como Get-SCOMManagementPack que obtém objetos do pacote de gerenciamento.

Propriedades do parâmetro

Tipo:

ManagementPack[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromManagementPack
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica uma matriz de nomes de tarefas.

O cmdlet usa cada cadeia de caracteres na matriz e a corresponde às propriedades Name dos objetos de tarefa com os quais esse cmdlet funciona.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

FromTaskName
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:

ManagementPackClass[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromManagementPackClass
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.