Partager via


Set-SCOMLocation

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

Syntaxe

FromAgent (Par défaut)

Set-SCOMLocation
    [-Agent] <AgentManagedComputer[]>
    -Location <EnterpriseManagementObject>
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromManagementServer

Set-SCOMLocation
    [-ManagementServer] <ManagementServer[]>
    -Location <EnterpriseManagementObject>
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromPool

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 .

Propriétés du paramètre

Type:

AgentManagedComputer[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromAgent
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Location

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

Propriétés du paramètre

Type:EnterpriseManagementObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:

ManagementServer[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromManagementServer
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:

ManagementServicePool[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromPool
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SCSession

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

Propriétés du paramètre

Type:

Connection[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.