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.

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

L’applet de commande Set-SCOMLocation associe un ou plusieurs ordinateurs gérés par l’agent, des serveurs d’administration ou des pools de ressources à un emplacement. Cette applet de commande supprime une association actuelle, si elle existe. Le tableau de bord récapitulative de surveillance de la disponibilité 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 l’applet de commande 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 autre connexion persistante. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential . Pour plus d'informations, voir 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 l’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 complet 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet PSCredential pour la connexion au groupe d’administration. Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential. Pour plus d'informations, voir 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

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

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

-ManagementServer

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

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 aucun résultat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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