Get-SCOMMaintenanceMode
Obtém entradas do modo de manutenção.
Syntax
Get-SCOMMaintenanceMode
[[-Instance] <MonitoringObject[]>]
[-History]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
O cmdlet Get-SCOMMaintenanceMode obtém entradas de modo de manutenção. Você pode usar esse cmdlet para fornecer objetos ao cmdlet Set-SCOMMaintenanceMode ou por si só para ver detalhes sobre entradas do modo de manutenção.
Quando um recurso está no modo de manutenção, o System Center – Operations Manager suprime alertas, notificações, regras, monitores, respostas automáticas, alterações de estado e novos alertas.
Quando você usa esse cmdlet por si só, ele apresenta informações para a hora local.
Se você redirecionar seus resultados para o cmdlet Format-Table , o cmdlet fornecerá informações em UTC (Tempo Universal Coordenado).
Para obter mais informações sobre Format-Table, digite . Get-Help Format-Table
Por padrão, esse cmdlet usa 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
.
Exemplos
Exemplo 1: Obter todas as entradas do modo de manutenção ativa
PS C:\>Get-SCOMMaintenanceMode
Esse comando obtém todas as entradas do modo de manutenção ativa. Para incluir entradas inativas, especifique o parâmetro Histórico .
Exemplo 2: Obter todas as entradas do modo de manutenção ativa para um domínio especificado
PS C:\>Get-SCOMMaintenanceMode -Instance (Get-SCOMClassInstance -Name "*.Contoso.com") -ErrorAction SilentlyContinue
Esse comando obtém todas as entradas do modo de manutenção ativa para instâncias de classe no domínio Contoso.com. O comando usa o cmdlet Get-SCOMClassInstance para obter as instâncias que contêm Contoso.com.
Se o comando encontrar uma instância de classe que não tenha entradas de modo de manutenção ativas, o parâmetro ErrorAction permitirá que o comando continue sem exibir um erro.
Exemplo 3: Obter todas as entradas do modo de manutenção para um domínio especificado
PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMMaintenanceMode -History
Esse comando obtém todas as instâncias de classe no domínio Contoso.com e usa o operador de pipeline (|) para passar os objetos de instância de classe para o cmdlet Get-SCOMMaintenanceMode . Este exemplo usa o parâmetro History ; portanto, o comando obtém todas as entradas do modo de manutenção, incluindo entradas inativas.
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 estar em execução no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica um objeto PSCredential para a conexão do grupo de gerenciamento.
Para obter um objeto PSCredential, use o cmdlet Get-Credential.
Para obter mais informações, 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-History
Indica que o cmdlet obtém todas as entradas do modo de manutenção, incluindo entradas inativas. Sem esse parâmetro, o cmdlet obtém apenas entradas do modo de manutenção ativa.
Type: | SwitchParameter |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Instance
Especifica uma matriz de objetos de monitoramento que representam instâncias. Para obter objetos de monitoramento, use o cmdlet Get-SCOMClassInstance .
Esse parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup .
Type: | MonitoringObject[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Especifica uma matriz de objetos Connection . Para obter um objeto Connection , use o cmdlet Get-SCOMManagementGroupConnection .
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |