Udostępnij przez


Add-SCOMADAgentAssignment

Przypisuje komputery zarządzane przez agenta usług AD DS do grupy zarządzania.

Składnia

Default (Domyślna)

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

Opis

Polecenie cmdlet add-SCOMADAgentAssignment przypisuje co najmniej jeden komputer zarządzany przez agenta usług Active Directory Domain Services (AD DS) do grupy zarządzania programu System Center — Operations Manager.

Przed użyciem tego polecenia cmdlet w celu przypisania komputerów zarządzanych przez agenta do grupy zarządzania użyj MOMADAdmin.exe, aby utworzyć kontener usług AD DS dla grupy zarządzania programu Operations Manager w domenie komputerów.

Przykłady

Przykład 1. Przypisywanie komputerów zarządzanych przez agenta usług AD DS do grupy zarządzania

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"

W tym przykładzie komputer zarządzany przez agenta usług AD DS jest przypisywany do grupy zarządzania.

Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie DivMgmtSvr01.fabrikam.net i przechowuje obiekt w zmiennej $PrimaryServer.

Drugie polecenie określa zapytanie LDAP, które wybiera komputery o nazwach, takich jak SQLServer*.fabrikam.net, i przechowuje obiekt w zmiennej $Ldap.

Trzecie polecenie przypisuje komputery zarządzane przez agenta usług AD DS przechowywane w $Ldap do grupy zarządzania w domenie fabrikam.net. Polecenie wyklucza komputer o nazwie SQLServer05.fabrikam.net z grupy zarządzania.

Przykład 2. Ustawianie trybu failover dla przypisania agenta usług 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

W tym przykładzie komputer zarządzany przez agenta usług AD DS jest przypisywany do grupy zarządzania i ustawia tryb failover dla agenta.

Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie DivMgmtSvr01.fabrikam.net i przechowuje obiekt w zmiennej $PrimaryServer.

Drugie polecenie pobiera serwery zarządzania o nazwie takiej jak FabrikamSecondary*.fabrikam.net i przechowuje obiekty w zmiennej $Failovers.

Trzecie polecenie pobiera obiekt profilu Uruchom jako o nazwie "Konto przypisania agenta opartego na usłudze Active Directory" i przechowuje obiekt w zmiennej $RunAs.

Czwarte polecenie określa zapytanie LDAP, które wybiera komputery o nazwach, takich jak SQLServer*.fabrikam.net, i przechowuje wynik w zmiennej $Ldap.

Piąte polecenie przypisuje komputery zarządzane przez agenta usług AD DS przechowywane w $Ldap do grupy zarządzania w domenie fabrikam.net. Polecenie określa podstawowy serwer zarządzania przechowywany w $PrimaryServer dla komputerów zarządzanych przez agenta. Polecenie określa serwery zarządzania przechowywane w $Failovers jako tryb failover dla komputerów zarządzanych przez agenta. Polecenie określa profil Uruchom jako przechowywany w $RunAs dla komputerów zarządzanych przez agenta.

Parametry

-ComputerName

Określa tablicę nazw komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Na komputerze musi być uruchomiona usługa System Center Data Access. Jeśli komputer nie zostanie określony, polecenie cmdlet używa komputera dla bieżącego połączenia grupy zarządzania.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Credential

Określa obiekt PSCredential dla połączenia grupy zarządzania. Aby uzyskać obiekt PSCredential, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.

Jeśli określisz komputer w parametrze ComputerName, użyj konta, które ma dostęp do tego komputera. Wartość domyślna to bieżący użytkownik.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Domain

Określa nazwę domeny lub kontrolera domeny, w którym znajdują się agenci docelowi.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:DC

Zestawy parametrów

(All)
Position:1
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Exclude

Określa tablicę nazw komputerów. Program Operations Manager wyklucza komputery określone z przypisania agenta.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-FailoverServer

Określa tablicę nazw obiektów ManagementServer. Ten parametr określa serwery zarządzania używane przez program Operations Manager jako tryb failover dla agentów docelowych.

Domyślnie program Operations Manager używa wszystkich serwerów zarządzania spoza bramy do pracy w trybie failover.

Właściwości parametru

Typ:

ManagementServer[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-LdapQuery

Określa zapytanie LDAP w domenie, która wybiera komputery agenta docelowego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:3
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrimaryServer

Określa obiekt ManagementServer. Ten parametr określa podstawowy serwer zarządzania dla komputera zarządzanego przez agenta docelowego. Aby uzyskać obiekt ManagementServer, użyj polecenia cmdlet Get-SCOMManagementServer.

Właściwości parametru

Typ:ManagementServer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:2
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsProfile

Określa profil Uruchom jako używany przez program Operations Manager do uruchamiania przepływu pracy zapytań usług AD DS.

Profil Uruchom jako musi być skojarzony z tym samym kontem Uruchom jako określonym podczas uruchamiania MOMADAdmin.exe w celu utworzenia kontenera usług AD DS dla grupy zarządzania programu System Center — Operations Manager.

Właściwości parametru

Typ:ManagementPackSecureReference
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SCSession

Określa tablicę obiektów połączenia . Aby uzyskać obiekt Connection, użyj polecenia cmdlet Get-SCOMManagementGroupConnection.

Obiekt połączenia reprezentuje połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.

Właściwości parametru

Typ:

Connection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.