Dela via

Set-SCOMLocation

  • Referens
Modul:
OperationsManager

Associerar agenthanterade datorer, hanteringsservrar eller resurspooler med en plats.

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

Description

Cmdleten Set-SCOMLocation associerar en eller flera agenthanterade datorer, hanteringsservrar eller resurspooler med en plats. Den här cmdleten tar bort en aktuell association, om en sådan finns. Instrumentpanelen för översiktskarta för webbprogramtillgänglighetsövervakning visar tillståndsinformation för agenter, hanteringsservrar och resurspooler som är associerade med en plats.

Du kan ta bort en association med hjälp av cmdleten Remove-SCOMLocation. Du kan skapa en plats med hjälp av cmdleten New-SCOMLocation.

Som standard använder den här cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Exempel

Exempel 1: Associera en agent med en plats

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

I det här exemplet associeras en agenthanterad dator med namnet Sever01.Contoso.com med platsen Seattle, WA. Det första kommandot hämtar platsobjektet som har visningsnamnet Seattle, WA och lagrar sedan objektet i variabeln $Location.

Det andra kommandot hämtar agentobjektet med namnet Server01.Contoso.com och lagrar sedan objektet i variabeln $Agent.

Det tredje kommandot associerar den plats som lagras i variabeln $Location med den agenthanterade datorn som lagras i variabeln $Agent. Om du tidigare har associerat den här agenthanterade datorn med en plats tar kommandot bort associationen.

Exempel 2: Associera en hanteringsserver med en plats

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

I det här exemplet associeras en hanteringsserver med namnet MgmtServer01.Contoso.com med platsen New York, NY. Det första kommandot hämtar platsobjektet som har visningsnamnet New York, NY och lagrar sedan objektet i variabeln $Location.

Det andra kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar objektet i variabeln $MgmtServer.

Det tredje kommandot associerar den plats som lagras i variabeln $Location med hanteringsservern som lagras i variabeln $MgmtServer. Om du tidigare har associerat den här hanteringsservern med en plats tar kommandot bort associationen.

Exempel 3: Associera en resurspool till en plats

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

I det här exemplet associeras en resurspool med namnet Notifications Resource Pool med platsen Paris, FR. Det första kommandot hämtar platsobjektet som har visningsnamnet Paris, FR och lagrar sedan objektet i variabeln $Location.

Det andra kommandot hämtar resurspoolen med namnet Meddelanden Resurspool och lagrar sedan objektet i variabeln $Pool.

Det tredje kommandot associerar den plats som lagras i variabeln $Location med resurspoolen som lagras i variabeln $Pool. Om du tidigare har associerat resurspoolen med en plats tar kommandot bort den associationen.

Parametrar

-Agent

Anger en matris med AgentManagedComputer objekt. Om du vill hämta ett AgentManagedComputer--objekt använder du cmdleten Get-SCOMAgent.

Typ:AgentManagedComputer[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste köras på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett PSCredential- objekt för hanteringsgruppens anslutning. Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Anger en plats som ett EnterpriseManagementObject- objekt. Om du vill hämta en plats använder du cmdleten Get-SCOMLocation.

Typ:EnterpriseManagementObject
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ManagementServer

Anger en matris med hanteringsserverobjekt. Om du vill hämta ett hanteringsserverobjekt använder du cmdleten Get-SCOMManagementServer.

Typ:ManagementServer[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Anger att cmdleten skapar eller ändrar ett objekt som ett kommando kan använda i pipelinen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Pool

Anger en matris med resurspoolobjekt. Om du vill hämta ett resurspoolobjekt använder du cmdleten Get-SCOMResourcePool.

Typ:ManagementServicePool[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta ett --objekt använder du cmdleten Get-SCOMManagementGroupConnection.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False