Compartilhar via

Add-SCOMADAgentAssignment

Módulo:
OperationsManager Module

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

Sintaxe

Default (Padrão) 

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 = "(&amp;(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 = "(&amp;(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.

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

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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 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.

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

-Domain

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:DC

Conjuntos de parâmetros

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

-Exclude

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

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

-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.

Propriedades do parâmetro

Tipo:

ManagementServer[]

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

-LdapQuery

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

Propriedades do parâmetro

Tipo:ManagementPackSecureReference
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

-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.

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

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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

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.