Partager via

Set-SCOMLocation

  • Référence
Module:
OperationsManager

Associe des ordinateurs gérés par l’agent, des serveurs d’administration ou des pools de ressources à un emplacement.

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

L’applet de commande set-SCOMLocation associe un ou plusieurs ordinateurs gérés par un agent, des serveurs d’administration ou des pools de ressources à un emplacement. Cette applet de commande supprime une association actuelle, le cas échéant. Le tableau de bord De synthèse de surveillance de la disponibilité des applications web affiche des informations d’état pour les agents, les serveurs d’administration et les pools de ressources associés à un emplacement.

Vous pouvez supprimer une association à l’aide de l’applet de commande Remove-SCOMLocation . Vous pouvez créer un emplacement à l’aide de la cmdlet New-SCOMLocation.

Par défaut, cette applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Exemples

Exemple 1 : Associer un agent à un emplacement

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

Cet exemple associe un ordinateur géré par un agent nommé Sever01.Contoso.com à l’emplacement Seattle, WA. La première commande obtient l’objet d’emplacement qui a le nom complet de Seattle, WA, puis stocke l’objet dans la variable $Location.

La deuxième commande obtient l’objet agent nommé Server01.Contoso.com, puis stocke l’objet dans la variable $Agent.

La troisième commande associe l’emplacement stocké dans la variable $Location à l’ordinateur géré par l’agent stocké dans la variable $Agent. Si vous avez précédemment associé cet ordinateur géré par l’agent à un emplacement, la commande supprime cette association.

Exemple 2 : Associer un serveur d’administration à un emplacement

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

Cet exemple associe un serveur d’administration nommé MgmtServer01.Contoso.com à l’emplacement New York, NY. La première commande obtient l’objet d’emplacement qui a le nom complet de New York, NY, puis stocke l’objet dans la variable $Location.

La deuxième commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com et stocke l’objet dans la variable $MgmtServer.

La troisième commande associe l’emplacement stocké dans la variable $Location au serveur d’administration stocké dans la variable $MgmtServer. Si vous avez précédemment associé ce serveur d’administration à un emplacement, la commande supprime cette association.

Exemple 3 : Associer un pool de ressources à un emplacement

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

Cet exemple associe un pool de ressources nommé Notifications Resource Pool à l’emplacement Paris, FR. La première commande obtient l’objet d’emplacement qui a le nom d’affichage Paris, FR, puis stocke l’objet dans la variable $Location.

La deuxième commande obtient le pool de ressources nommé Notifications Resource Pool, puis stocke l’objet dans la variable $Pool.

La troisième commande associe l’emplacement stocké dans la variable $Location au pool de ressources stocké dans la variable $Pool. Si vous avez précédemment associé le pool de ressources à un emplacement, la commande supprime cette association.

Paramètres

-Agent

Spécifie un tableau d’objets AgentManagedComputer. Pour obtenir un objet AgentManagedComputer, utilisez l’applet de commande Get-SCOMAgent .

Type:AgentManagedComputer[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

Le service System Center Data Access doit s’exécuter sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un objet PSCredential pour la connexion de groupe d’administration. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Location

Spécifie un emplacement en tant qu’objet EnterpriseManagementObject. Pour obtenir un emplacement, utilisez l’applet de commande Get-SCOMLocation Get-SCOMLocation.

Type:EnterpriseManagementObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagementServer

Spécifie un tableau d’objets de serveur d’administration. Pour obtenir un objet de serveur d’administration, utilisez l’applet de commande Get-SCOMManagementServer .

Type:ManagementServer[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Pool

Spécifie un tableau d’objets de pool de ressources. Pour obtenir un objet de pool de ressources, utilisez l’applet de commande Get-SCOMResourcePool .

Type:ManagementServicePool[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir un objet Connection, utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Type:Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False