Compartilhar via


Add-SCOMADAgentAssignment

Atribui computadores gerenciados por agente do AD DS ao grupo de gerenciamento.

Sintaxe

Add-SCOMADAgentAssignment
   [-Domain] <String>
   [-PrimaryServer] <ManagementServer>
   [-LdapQuery] <String>
   [-RunAsProfile <ManagementPackSecureReference>]
   [-FailoverServer <ManagementServer[]>]
   [-Exclude <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Add-SCOMADAgentAssignment atribui um ou mais computadores gerenciados por agente do AD DS (Active Directory Domain Services) ao grupo de gerenciamento do System Center – Operations Manager.

Antes de usar esse cmdlet para atribuir computadores gerenciados por agente ao grupo de gerenciamento, use MOMADAdmin.exe para criar um contêiner do AD DS para um grupo de gerenciamento do Operations Manager no domínio dos computadores.

Exemplos

Exemplo 1: Atribuir computadores gerenciados por agente do AD DS ao grupo de gerenciamento

PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -Exclude "SQLServer05.fabrikam.net"

Este exemplo atribui um computador gerenciado por agente do AD DS ao grupo de gerenciamento.

O primeiro comando obtém o objeto do servidor de gerenciamento chamado DivMgmtSvr01.fabrikam.net e armazena o objeto na variável $PrimaryServer.

O segundo comando especifica uma consulta LDAP que seleciona computadores com nomes como SQLServer*.fabrikam.net e armazena o objeto na variável $Ldap.

O terceiro comando atribui os computadores gerenciados pelo agente do AD DS armazenados em $Ldap ao grupo de gerenciamento no domínio fabrikam.net. O comando exclui o computador chamado SQLServer05.fabrikam.net do grupo de gerenciamento.

Exemplo 2: definir failovers para uma atribuição de agente do AD DS

PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Failovers = Get-SCOMManagementServer -Name "FabrikamSecondary*.fabrikam.net"
PS C:\> $RunAs = Get-SCOMRunAsProfile -Name "Active Directory Based Agent Assignment Account"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAs

Este exemplo atribui um computador gerenciado por agente do AD DS ao grupo de gerenciamento e define os failovers do agente.

O primeiro comando obtém o objeto do servidor de gerenciamento chamado DivMgmtSvr01.fabrikam.net e armazena o objeto na variável $PrimaryServer.

O segundo comando obtém os servidores de gerenciamento com um nome como FabrikamSecondary*.fabrikam.net e armazena os objetos na variável $Failovers.

O terceiro comando obtém o objeto de perfil Executar como chamado "Conta de Atribuição de Agente Baseado no Active Directory" e armazena o objeto na variável $RunAs.

O quarto comando especifica uma consulta LDAP que seleciona computadores com nomes como SQLServer*.fabrikam.net e armazena o resultado na variável $Ldap.

O quinto comando atribui os computadores gerenciados pelo agente do AD DS armazenados em $Ldap ao grupo de gerenciamento no domínio fabrikam.net. O comando especifica o servidor de gerenciamento primário armazenado em $PrimaryServer para os computadores gerenciados pelo agente. O comando especifica os servidores de gerenciamento armazenados em $Failovers como failovers para os computadores gerenciados pelo agente. O comando especifica o perfil Executar como armazenado em $RunAs para os computadores gerenciados pelo agente.

Parâmetros

-ComputerName

Especifica uma matriz de nomes de 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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Domain

Especifica o nome do domínio ou controlador de domínio no qual residem os agentes de destino.

Tipo:String
Aliases:DC
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Exclude

Especifica uma matriz de nomes de computadores. O Operations Manager exclui os computadores especificados da atribuição do agente.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FailoverServer

Especifica uma matriz de nomes de objetos ManagementServer. Esse parâmetro especifica os servidores de gerenciamento que o Operations Manager usa como failovers para os agentes de destino.

Por padrão, o Operations Manager usa todos os servidores de gerenciamento que não são de gateway para failover.

Tipo:ManagementServer[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LdapQuery

Especifica a consulta LDAP no domínio que seleciona os computadores do agente de destino.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrimaryServer

Especifica um objeto ManagementServer. Esse parâmetro especifica o servidor de gerenciamento primário para o computador gerenciado pelo agente de destino. Para obter um objeto ManagementServer, use o cmdlet Get-SCOMManagementServer.

Tipo:ManagementServer
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsProfile

Especifica o perfil Executar como usado pelo Operations Manager para executar o fluxo de trabalho de consulta do AD DS.

O perfil Executar como deve ser associado à mesma conta RunAs que você especifica ao executar MOMADAdmin.exe para criar um contêiner do AD DS para um grupo de gerenciamento do System Center – Operations Manager.

Tipo:ManagementPackSecureReference
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection .

Um objeto de conexão representa uma conexão com um servidor de gerenciamento. O padrão é a conexão do grupo de gerenciamento atual.

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False