Add-SCOMADAgentAssignment
Atribui computadores gerenciados por agente do AD DS ao grupo de gerenciamento.
Syntax
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 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 por 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 para o 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 Executa 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 por 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
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 |
-Domain
Especifica o nome do domínio ou controlador de domínio no qual residem os agentes de destino.
Type: | String |
Aliases: | DC |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Especifica uma matriz de nomes de computadores. O Operations Manager exclui os computadores que você especificar da atribuição de agente.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 não gateway para failover.
Type: | ManagementServer[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LdapQuery
Especifica a consulta LDAP no domínio que seleciona os computadores do agente de destino.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | ManagementServer |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsProfile
Especifica o perfil Executar como que o Operations Manager usa 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.
Type: | ManagementPackSecureReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 atual de grupo de gerenciamento.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |