Compartilhar via

Update-SCOMADAgentAssignment

Módulo:
OperationsManager Module

Altera as configurações de uma atribuição de agente do AD DS.

Sintaxe

Default (Padrão) 

Update-SCOMADAgentAssignment
    -AgentAssignment <AgentAssignment>
    -PrimaryServer <ManagementServer>
    [[-LdapQuery] <String>]
    [-Exclude <String[]>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Update-SCOMADAgentAssignment altera as configurações de uma atribuição de agente do AD DS (Active Directory Domain Services). Você pode usar esse cmdlet para alterar as configurações de lista de exclusão e consulta LDAP da atribuição do agente. Para alterar outras configurações da atribuição do agente, remova a atribuição do agente e recuree-a.

Exemplos

Exemplo 1: alterar a consulta LDAP para uma atribuição de agente

PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Update-SCOMADAgentAssignment -LdapQuery "(&amp;(sAMAccountType=805306369)(name=SQLSERVER*))"

Esse comando obtém a atribuição de agente do AD DS para um domínio. O comando usa o cmdlet Get-SCOMADAgentAssignment para obter a atribuição de agente do AD DS chamada contoso.com e passa o resultado para o cmdlet Update-SCOMADAgentAssignment do usando o operador de pipeline. O comando altera a consulta LDAP da atribuição do agente para o domínio chamado contoso.com para retornar apenas computadores com nomes que correspondam ao SQLSERVER.

Parâmetros

-AgentAssignment

Especifica um objeto AgentAssignment. Para obter um objeto AgentAssignment, use o cmdlet Get-SCOMADAgentAssignment.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-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

-Exclude

Especifica uma matriz de nomes de computadores. O Operations Manager exclui os computadores especificados da atribuição do agente. O Operations Manager exclui esses computadores mesmo que a consulta LDAP retorne os computadores.

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

-LdapQuery

Especifica a consulta LDAP no domínio que seleciona os computadores do agente de destino. Se você não especificar esse parâmetro, o cmdlet usará a consulta LDAP atual.

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:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída.

Propriedades do parâmetro

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

-PrimaryServer

Especifica um objeto ManagementServer. Esse parâmetro especifica o servidor de gerenciamento primário para os computadores gerenciados 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:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
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.