Add-SCOMADAgentAssignment
Atribui computadores geridos por agentes AD ao grupo de gestão.
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 geridos por agentes Ative Directory Domain Services (AD DS) ao grupo de gestão do System Center 2019 - Gestor de Operações.
Antes de utilizar este cmdlet para atribuir computadores geridos por agentes ao grupo de gestão, utilize MOMADAdmin.exe para criar um contentor AD DS para um grupo de gestão de Gestores de Operações no domínio dos computadores.
Exemplos
Exemplo 1: Atribuir computadores geridos por agentes AD DS ao grupo de gestão
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 gerido por DS AD ao grupo de gestão.
O primeiro comando obtém o objeto do servidor de gestão nomeado 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 geridos pelo agente AD DS armazenados em $Ldap ao grupo de gestão no domínio fabrikam.net. O comando exclui o computador nomeado SQLServer05.fabrikam.net do grupo de gestão.
Exemplo 2: Definir falhas para uma atribuição de agente DS AD
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 gerido por DS AD ao grupo de gestão e define as falhas para o agente.
O primeiro comando obtém o objeto do servidor de gestão nomeado DivMgmtSvr01.fabrikam.net, e armazena o objeto na variável $PrimaryServer.
O segundo comando recebe os servidores de gestão com um nome como FabrikamSecondary*.fabrikam.net, e armazena os objetos na variável $Failovers.
O terceiro comando obtém o objeto de perfil Runs As chamado "Ative Directory Account" 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 geridos pelo agente AD DS armazenados em $Ldap ao grupo de gestão no domínio fabrikam.net. O comando especifica o servidor de gestão primária armazenado em $PrimaryServer para os computadores geridos pelo agente. O comando especifica os servidores de gestão armazenados em $Failovers como falhas para os computadores geridos pelo agente. O comando especifica o perfil Run As armazenado em $RunAs para os computadores geridos pelo agente.
Parâmetros
-ComputerName
Especifica uma série de nomes de computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).
O serviço de acesso a dados do Centro de Sistemas deve estar a funcionar no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a 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 ligação do grupo de gestão.
Para obter um objeto PSCredential , utilize o cmdlet Get-Credential .
Para mais informações, insira Get-Help Get-Credential
.
Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador 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-alvo.
Type: | String |
Aliases: | DC |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Especifica uma série de nomes de computadores. O Gestor de Operações exclui os computadores que especifica da atribuição do agente.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailoverServer
Especifica uma série de nomes de objetos ManagementServer . Este parâmetro especifica os servidores de gestão que o Gestor de Operações utiliza como failovers para os agentes-alvo.
Por predefinição, o Gestor de Operações utiliza todos os servidores de gestão não gateway para o 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-alvo.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrimaryServer
Especifica um objeto ManagementServer . Este parâmetro especifica o servidor de gestão primária para o computador gerido pelo agente alvo. Para obter um objeto ManagementServer , utilize 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 Run As que o Gestor de Operações utiliza para executar o fluxo de trabalho de consulta AD DS.
O perfil Run As deve ser associado à mesma conta RunAs que especifique quando corre MOMADAdmin.exe para criar um contentor AD DS para um Grupo de Gestão de Gestores de Operações 2019 - Gestor de Operações.
Type: | ManagementPackSecureReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
Especifica uma matriz de objetos de ligação . Para obter um objeto de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .
Um objeto de ligação representa uma ligação a um servidor de gestão. O padrão é a ligação do grupo de gestão atual.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |