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
Vous pouvez supprimer une association à l’aide de l’applet de commande Remove-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 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
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 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
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
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.