Compartilhar via


Get-SCOMRule

Obtém regras de monitoramento do Operations Manager.

Sintaxe

Empty (Padrão)

Get-SCOMRule
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringRuleName

Get-SCOMRule
    -Name <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringDisplayRuleName

Get-SCOMRule
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromMonitoringRuleId

Get-SCOMRule
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPack

Get-SCOMRule
    [-ManagementPack] <ManagementPack[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPackClass

Get-SCOMRule
    [-Target] <ManagementPackClass[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

O cmdlet Get-SCOMRule obtém regras de monitoramento para o System Center – Operations Manager.

Exemplos

Exemplo 1: Obter regras de monitoramento especificando nomes com curinga

PS C:\>Get-SCOMRule -Name "*health*"

Esse comando obtém todas as regras de monitoramento que têm integridade em seu nome.

Exemplo 2: Obter regras de monitoramento especificando nomes de exibição com um curinga

PS C:\>Get-SCOMRule -DisplayName "*performance*"

Esse comando obtém todas as regras de monitoramento com desempenho em seu nome de exibição.

Exemplo 3: Obter uma regra de monitoramento especificando um pacote de gerenciamento

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core Monitoring" | Get-SCOMRule

Esse comando obtém todos os pacotes de gerenciamento com o Monitoramento do System Center Core em seus nomes de exibição. Em seguida, ele usa o operador de pipeline para enviar os objetos do pacote de gerenciamento para o cmdlet Get-SCOMRule, que obtém as regras de monitoramento para cada objeto do pacote de gerenciamento.

Exemplo 4: Obter regras de monitoramento especificando classes de destino com um curinga

PS C:\>Get-SCOMRule -Target (Get-SCOMClass -DisplayName "*health*")

Esse comando obtém as regras de monitoramento para cada classe de destino que tem integridade em seu nome de exibição.

Exemplo 5: obter regras de monitoramento especificando um pacote de gerenciamento com o caminho:

PS C:\>$MPFile = "D:\Program Files\System Center Operations Manager 2007\Microsoft.SystemCenter.2007.mp"
PS C:\> Get-SCOMRule -ManagementPack $MPFile

Este exemplo obtém regras de monitoramento para um pacote de gerenciamento em um caminho especificado.

O primeiro comando obtém o caminho para um arquivo de pacote de gerenciamento e o armazena na variável $MPFile.

O segundo comando usa o parâmetro ManagementPack para obter as regras de monitoramento do pacote de gerenciamento armazenado na variável $MPFile.

Exemplo 6: Obter uma regra de monitoramento especificando um GUID

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

Esse comando obtém a regra de monitoramento 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 serviço de Acesso a Dados do System Center deve ser iniciado no computador. Se você não especificar um computador, o cmdlet usará 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.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o 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. Esse cmdlet usa as cadeias de caracteres nesta matriz e procura correspondências entre as propriedades DisplayName dos objetos com os quais o cmdlet funciona. DisplayName valores dependem dos pacotes de gerenciamento localizados e importados que fazem parte do grupo de gerenciamento e da localidade do usuário que executa o Windows PowerShell

Se esse parâmetro não aparecer, a descrição padrão será aquela no parâmetro nome do .

Propriedades do parâmetro

Tipo:

String[]

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

Conjuntos de parâmetros

FromMonitoringDisplayRuleName
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 para regras de monitoramento. O cmdlet obtém regras de monitoramento que correspondem aos GUIDs.

Um objeto SCOMGroup armazena o GUID em sua propriedade de ID. Para obter o GUID de uma classe, digite Get-SCOMGroup | Format-Table DisplayName, Id.

Propriedades do parâmetro

Tipo:

Guid[]

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

Conjuntos de parâmetros

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

-ManagementPack

Especifica um objeto de pacote de gerenciamento que armazena substituições. Para obter um objeto de pacote de gerenciamento, use o cmdlet Get-SCOMManagementPack. Se a regra estiver em um pacote de gerenciamento sem lacre, você deverá salvar a substituição no mesmo 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 objeto.

Esse parâmetro usa cada cadeia de caracteres na matriz e procura correspondências entre as propriedades Name dos objetos com os quais o cmdlet funciona.

Propriedades do parâmetro

Tipo:

String[]

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

Conjuntos de parâmetros

FromMonitoringRuleName
Cargo:Named
Obrigatório:True
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, use o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não for especificado, 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 ManagementPackClass. Para obter um objeto ManagementPackClass, use o cmdlet Get-SCClass . O cmdlet obtém regras de monitoramento para essas classes.

Propriedades do parâmetro

Tipo:

ManagementPackClass[]

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

Conjuntos de parâmetros

FromManagementPackClass
Cargo:1
Obrigatório:True
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.