Set-SCOMLocation

Modul:

OperationsManager

Ordnet Agent-verwaltete Computer, Verwaltungsserver oder Ressourcenpools einem Speicherort zu.

Syntax

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCOMLocation verknüpft einen oder mehrere verwaltete Computer, Verwaltungsserver oder Ressourcenpools mit einem Speicherort. Dieses Cmdlet entfernt eine aktuelle Zuordnung, wenn eine vorhanden ist. Das Übersichtsdashboard für die Webanwendungsverfügbarkeitszuordnung zeigt Statusinformationen für Agents, Verwaltungsserver und Ressourcenpools an, die einem Speicherort zugeordnet sind.

Sie können eine Zuordnung mithilfe des Cmdlets Remove-SCOMLocation entfernen. Sie können einen Speicherort mithilfe des Cmdlets New-SCOMLocation erstellen.

Standardmäßig verwendet dieses Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Beispiele

Beispiel 1: Zuordnen eines Agents zu einem Speicherort

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent

In diesem Beispiel wird ein Agent verwalteter Computer namens Sever01.Contoso.com dem Speicherort Seattle, WA zugeordnet. Der erste Befehl ruft das Speicherortobjekt ab, das den Anzeigenamen von Seattle, WA aufweist und dann das Objekt in der $Location Variablen speichert.

Der zweite Befehl ruft das Agentobjekt namens Server01.Contoso.com ab und speichert dann das Objekt in der $Agent Variablen.

Der dritte Befehl verknüpft den Speicherort, der in der $Location Variablen gespeichert ist, mit dem in der $Agent Variablen gespeicherten Agent-Computer. Wenn Sie diesen Agent-verwalteten Computer zuvor einem Speicherort zugeordnet haben, entfernt der Befehl diese Zuordnung.

Beispiel 2: Zuordnen eines Verwaltungsservers zu einem Speicherort

PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer

In diesem Beispiel wird ein Verwaltungsserver namens MgmtServer01.Contoso.com dem Standort New York, NY zugeordnet. Der erste Befehl ruft das Speicherortobjekt ab, das den Anzeigenamen von New York, NY aufweist und dann das Objekt in der $Location Variable speichert.

Der zweite Befehl ruft das Verwaltungsserverobjekt namens MgmtServer01.Contoso.com ab und speichert das Objekt in der $MgmtServer Variablen.

Der dritte Befehl verknüpft den Speicherort, der in der $Location Variablen gespeichert ist, dem Verwaltungsserver, der in der $MgmtServer Variablen gespeichert ist. Wenn Sie diesen Verwaltungsserver zuvor einem Speicherort zugeordnet haben, entfernt der Befehl diese Zuordnung.

Beispiel 3: Zuordnen eines Ressourcenpools zu einem Speicherort

PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool

In diesem Beispiel wird ein Ressourcenpool namens "Notification Resource Pool" mit dem Standort Paris, FR verknüpft. Der erste Befehl ruft das Standortobjekt ab, das den Anzeigenamen Paris, FR aufweist und dann das Objekt in der $Location Variablen speichert.

Der zweite Befehl ruft den Ressourcenpool namens "Notification Resource Pool" ab und speichert dann das Objekt in der $Pool Variablen.

Der dritte Befehl verknüpft den Speicherort, der in der $Location Variablen gespeichert ist, dem Ressourcenpool, der in der $Pool Variable gespeichert ist. Wenn Sie dem Ressourcenpool zuvor einen Speicherort zugeordnet haben, entfernt der Befehl diese Zuordnung.

Parameter

-Agent

Gibt ein Array von AgentManagedComputer-Objekten an. Verwenden Sie zum Abrufen eines AgentManagedComputer-Objekts das Cmdlet Get-SCOMAgent .

Type:	AgentManagedComputer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers 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

-Location

Gibt einen Speicherort als EnterpriseManagementObject-Objekt an. Verwenden Sie zum Abrufen eines Speicherorts das Cmdlet "Get-SCOMLocation ".

Type:	EnterpriseManagementObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagementServer

Gibt ein Array von Verwaltungsserverobjekten an. Verwenden Sie zum Abrufen eines Verwaltungsserverobjekts das Cmdlet Get-SCOMManagementServer .

Type:	ManagementServer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
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

-Pool

Gibt ein Array von Ressourcenpoolobjekten an. Verwenden Sie zum Abrufen eines Ressourcenpoolobjekts das Cmdlet Get-SCOMResourcePool .

Type:	ManagementServicePool[]
Position:	1
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.

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

Ähnliche Themen

• Get-SCOMAgent
• Get-SCOMManagementServer
• Get-SCOMResourcePool
• Get-SCOMLocation
• New-SCOMLocation
• Remove-SCOMLocation
• Update-SCOMLocation