Condividi tramite

Set-SCOMLocation

  • Riferimento
Modulo:
OperationsManager

Associa computer gestiti dall'agente, server di gestione o pool di risorse a una posizione.

Sintassi

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

Descrizione

Il cmdlet Set-SCOMLocation associa uno o più computer gestiti dall'agente, server di gestione o pool di risorse a una posizione. Questo cmdlet rimuove un'associazione corrente, se presente. Il dashboard della mappa riepilogo monitoraggio disponibilità applicazione Web visualizza le informazioni sullo stato per agenti, server di gestione e pool di risorse associati a una posizione.

È possibile rimuovere un'associazione usando il cmdlet Remove-SCOMLocation . È possibile creare un percorso usando il cmdlet New-SCOMLocation .

Per impostazione predefinita, questo cmdlet usa la connessione permanente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione permanente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e credenziali. Per altre informazioni, digitare Get-Help about_OpsMgr_Connections.

Esempio

Esempio 1: Associare un agente a una posizione

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

Questo esempio associa un computer gestito dall'agente denominato Sever01.Contoso.com alla località Seattle, WA. Il primo comando ottiene l'oggetto location con il nome visualizzato di Seattle, WA e quindi archivia l'oggetto nella variabile $Location.

Il secondo comando ottiene l'oggetto agente denominato Server01.Contoso.com e quindi archivia l'oggetto nella variabile $Agent.

Il terzo comando associa il percorso archiviato nella variabile $Location al computer gestito dall'agente archiviato nella variabile $Agent. Se il computer gestito dall'agente è stato associato in precedenza a un percorso, il comando rimuove tale associazione.

Esempio 2: Associare un server di gestione a una posizione

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 questo esempio viene associato un server di gestione denominato MgmtServer01.Contoso.com alla località New York, NY. Il primo comando ottiene l'oggetto location con il nome visualizzato di New York, NY e quindi archivia l'oggetto nella variabile $Location.

Il secondo comando ottiene l'oggetto server di gestione denominato MgmtServer01.Contoso.com e archivia l'oggetto nella variabile $MgmtServer.

Il terzo comando associa il percorso archiviato nella variabile $Location al server di gestione archiviato nella variabile $MgmtServer. Se questo server di gestione è stato associato in precedenza a un percorso, il comando rimuove tale associazione.

Esempio 3: Associare un pool di risorse a una posizione

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 questo esempio viene associato un pool di risorse denominato Pool di risorse notifiche alla località Parigi, FR. Il primo comando ottiene l'oggetto location con il nome visualizzato Parigi, FR e quindi archivia l'oggetto nella variabile $Location.

Il secondo comando ottiene il pool di risorse denominato Pool di risorse notifiche e quindi archivia l'oggetto nella variabile $Pool.

Il terzo comando associa la posizione archiviata nella variabile $Location al pool di risorse archiviato nella variabile $Pool. Se il pool di risorse è stato associato in precedenza a un percorso, il comando rimuove tale associazione.

Parametri

-Agent

Specifica una matrice di oggetti AgentManagedComputer. Per ottenere un oggetto AgentManagedComputer, utilizzare il cmdlet Get-SCOMAgent .

Tipo:AgentManagedComputer[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio Di accesso ai dati di System Center deve essere in esecuzione nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione al gruppo di gestione corrente.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un oggetto PSCredential per la connessione al gruppo di gestione. Per ottenere un oggetto PSCredential , usare il cmdlet Get-Credential . Per altre informazioni, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName, utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Location

Specifica una posizione come oggetto EnterpriseManagementObject. Per ottenere un percorso, usare il cmdlet Get-SCOMLocation .

Tipo:EnterpriseManagementObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ManagementServer

Specifica una matrice di oggetti server di gestione. Per ottenere un oggetto server di gestione, usare il cmdlet Get-SCOMManagementServer .

Tipo:ManagementServer[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Indica che il cmdlet crea o modifica un oggetto che un comando può usare nella pipeline. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Pool

Specifica una matrice di oggetti pool di risorse. Per ottenere un oggetto pool di risorse, usare il cmdlet Get-SCOMResourcePool .

Tipo:ManagementServicePool[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SCSession

Specifica una matrice di oggetti Connection. Per ottenere un oggetto Connection , utilizzare il cmdlet Get-SCOMManagementGroupConnection .

Tipo:Connection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False