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 di riepilogo della mappa di riepilogo della disponibilità dell'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 una posizione usando il cmdlet New-SCOMLocation .

Per impostazione predefinita, questo cmdlet usa la connessione persistente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione persistente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e Credential . Per ulteriori 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

In questo esempio viene associato 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 agent denominato Server01.Contoso.com e quindi archivia l'oggetto nella variabile $Agent.

Il terzo comando associa la posizione archiviata nella variabile $Location al computer gestito dall'agente archiviato nella variabile $Agent. Se in precedenza si associa questo computer gestito dall'agente 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 posizione di 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 la posizione archiviata nella variabile $Location al server di gestione archiviato nella variabile $MgmtServer. Se in precedenza il server di gestione è associato 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 posizione di 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 con il pool di risorse archiviato nella variabile $Pool. Se in precedenza è stato associato il pool di risorse a una posizione, il comando rimuove tale associazione.

Parametri

-Agent

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

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 System Center Data Access deve essere in esecuzione nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione del gruppo di gestione corrente.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

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

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

-Location

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

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

-ManagementServer

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

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

-PassThru

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

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

-Pool

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

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

-SCSession

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False