Sdílet prostřednictvím

Set-SCOMLocation

  • Reference
Modul:
OperationsManager

Přidruží počítače spravované agentem, servery pro správu nebo fondy zdrojů k umístění.

Syntaxe

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>]

Description

Rutina Set-SCOMLocation přidruží k umístění jeden nebo více počítačů spravovaných agentem, serverů pro správu nebo fondů zdrojů. Tato rutina odebere aktuální přidružení, pokud existuje. Řídicí panel souhrnné mapy monitorování dostupnosti webových aplikací zobrazuje informace o stavu pro agenty, servery pro správu a fondy zdrojů přidružené k umístění.

Přidružení můžete odebrat pomocí rutiny Remove-SCOMLocation. Umístění můžete vytvořit pomocí rutiny New-SCOMLocation.

Ve výchozím nastavení tato rutina používá aktivní trvalé připojení ke skupině pro správu. Pomocí parametru SCSession zadejte jiné trvalé připojení. Dočasné připojení ke skupině pro správu můžete vytvořit pomocí parametrů ComputerName a přihlašovacích údajů. Další informace potřebujete zadáním Get-Help about_OpsMgr_Connections.

Příklady

Příklad 1: Přidružení agenta k umístění

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

Tento příklad přidruží počítač spravovaný agentem s názvem Sever01.Contoso.com k umístění Seattle, WA. První příkaz získá objekt umístění, který má zobrazovaný název Seattle, WA a pak uloží objekt do $Location proměnné.

Druhý příkaz získá objekt agenta s názvem Server01.Contoso.com a pak uloží objekt do proměnné $Agent.

Třetí příkaz přidruží umístění uložené v proměnné $Location k počítači spravovanému agentem uloženým v proměnné $Agent. Pokud jste tento počítač spravovaný agentem dříve přidružli k umístění, příkaz toto přidružení odebere.

Příklad 2: Přidružení serveru pro správu k umístění

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

Tento příklad přidruží server pro správu s názvem MgmtServer01.Contoso.com k umístění New York, NY. První příkaz získá objekt umístění, který má zobrazovaný název New Yorku, NY a pak uloží objekt do proměnné $Location.

Druhý příkaz získá objekt serveru pro správu s názvem MgmtServer01.Contoso.com a uloží objekt do proměnné $MgmtServer.

Třetí příkaz přidruží umístění uložené v proměnné $Location k serveru pro správu uloženému v proměnné $MgmtServer. Pokud jste tento server pro správu dříve přidružli k umístění, příkaz toto přidružení odebere.

Příklad 3: Přidružení fondu zdrojů k umístění

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

Tento příklad přidruží fond zdrojů s názvem Fond zdrojů oznámení k umístění Paříž, FR. První příkaz získá objekt umístění, který má zobrazovaný název Paříž, FR a pak uloží objekt do $Location proměnné.

Druhý příkaz získá fond zdrojů s názvem Notification Resource Pool a pak uloží objekt do $Pool proměnné.

Třetí příkaz přidruží umístění uložené v proměnné $Location k fondu zdrojů uloženému v proměnné $Pool. Pokud jste dříve přidružli fond zdrojů k umístění, příkaz toto přidružení odebere.

Parametry

-Agent

Určuje pole AgentManagedComputer objekty. K získání objektu AgentManagedComputer použijte rutinu Get-SCOMAgent.

Typ:AgentManagedComputer[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Na počítači musí být spuštěná služba System Center Data Access. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení skupiny pro správu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje objekt PSCredential pro připojení skupiny pro správu. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Pokud zadáte počítač v parametru ComputerName, použijte účet, který má přístup k danému počítači. Výchozí hodnota je aktuální uživatel.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Určuje umístění jako objekt EnterpriseManagementObject. K získání umístění použijte rutinu Get-SCOMLocation.

Typ:EnterpriseManagementObject
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ManagementServer

Určuje pole objektů serveru pro správu. K získání objektu serveru pro správu použijte rutinu Get-SCOMManagementServer.

Typ:ManagementServer[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

Označuje, že rutina vytvoří nebo upraví objekt, který může příkaz použít v kanálu. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Pool

Určuje pole objektů fondu zdrojů. K získání objektu fondu zdrojů použijte rutinu Get-SCOMResourcePool.

Typ:ManagementServicePool[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SCSession

Určuje pole objektů Connection. K získání objektu připojení použijte rutinu Get-SCOMManagementGroupConnection.

Typ:Connection[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False