Update-SCOMADAgentAssignment
Ändert die Einstellungen einer AD DS-Agent-Zuordnung.
Syntax
Update-SCOMADAgentAssignment
-AgentAssignment <AgentAssignment>
-PrimaryServer <ManagementServer>
[[-LdapQuery] <String>]
[-Exclude <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Update-SCOMADAgentAssignment ändert die Einstellungen einer Active Directory Domain Services (AD DS)-Agentzuweisung. Sie können dieses Cmdlet verwenden, um die LDAP-Abfrage- und Ausschlusslisteneinstellungen der Agentzuweisung zu ändern. Wenn Sie andere Einstellungen der Agentzuweisung ändern möchten, entfernen Sie die Agentzuweisung, und erstellen Sie sie erneut.
Beispiele
Beispiel 1: Ändern der LDAP-Abfrage für eine Agentzuweisung
PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Update-SCOMADAgentAssignment -LdapQuery "(&(sAMAccountType=805306369)(name=SQLSERVER*))"Dieser Befehl ruft die AD DS-Agent-Zuordnung für eine Domäne ab. Der Befehl verwendet das Cmdlet Get-SCOMADAgentAssignment , um die AD DS-Agent-Zuordnung mit dem Namen contoso.com abzurufen und das Ergebnis mithilfe des Pipelineoperators an das Cmdlet Update-SCOMADAgentAssignment zu übergeben. Der Befehl ändert die LDAP-Abfrage der Agentzuweisung für die Domäne namens contoso.com, um nur Computer mit Namen zurückzugeben, die SQLSERVER entsprechen.
Parameter
-AgentAssignment
Gibt ein AgentAssignment-Objekt an . Verwenden Sie zum Abrufen eines AgentAssignment-Objekts das Cmdlet Get-SCOMADAgentAssignment .
| Type: | AgentAssignment |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Gibt ein Array von Namen von Computern an. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, localhost oder einen Punkt (.) ein.
Der System Center Data Access-Dienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.
Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exclude
Gibt ein Array von Namen von Computern an. Operations Manager schließt die Computer aus, die Sie aus der Agentzuweisung angeben. Operations Manager schließt diese Computer aus, auch wenn die LDAP-Abfrage die Computer zurückgibt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LdapQuery
Gibt die LDAP-Abfrage in der Domäne an, die die Ziel-Agent-Computer auswählt. Wenn Sie diesen Parameter nicht angeben, verwendet das Cmdlet die aktuelle LDAP-Abfrage.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrimaryServer
Gibt ein ManagementServer-Objekt an. Dieser Parameter gibt den primären Verwaltungsserver für die verwalteten Ziel-Agent-Computer an. Verwenden Sie zum Abrufen eines ManagementServer-Objekts das Cmdlet Get-SCOMManagementServer .
| Type: | ManagementServer |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection.
Ein Verbindungsobjekt stellt eine Verbindung mit einem Verwaltungsserver dar. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |