Get-SCOMLocation
Obtient des emplacements.
Syntaxe
Empty (Par défaut)
Get-SCOMLocation
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgent
Get-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromPool
Get-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromDisplayName
Get-SCOMLocation
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMOIdParameterSetName
Get-SCOMLocation
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
L’applet de commande Get-SCOMLocation récupère les emplacements. Spécifiez les emplacements à obtenir par nom d’affichage ou ID, ou en spécifiant les agents, les serveurs de gestion ou les pools de ressources associés.
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, tapez Get-Help about_OpsMgr_Connections.
Exemples
Exemple 1 : Obtenir un emplacement par nom d’affichage
PS C:\>Get-SCOMLocation -DisplayName "Seattle, WA"
Cette commande obtient l’emplacement qui porte le nom d’affichage Seattle, WA.
Exemple 2 : Obtenir l’emplacement d’un ordinateur géré par un agent
PS C:\>$Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Get-SCOMLocation -Agent $Agent
Cet exemple obtient un emplacement pour un ordinateur géré par agent. La première commande obtient l’objet agent d’un ordinateur géré par un agent nommé Server01.Contoso.com, puis stocke l’objet dans la variable $Agent.
La deuxième commande obtient l’emplacement de l’objet agent stocké dans la variable $Agent.
Exemple 3 : Obtenir l’emplacement d’un serveur de gestion
PS C:\>$MgmtSvr = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMLocation -ManagementServer $MgmtSvr
Cet exemple obtient l’emplacement d’un serveur de gestion nommé MgmtServer01.Contoso.com. La première commande récupère l’objet du serveur de gestion nommé MgmtServer01.Contoso.com, puis stocke l’objet dans la variable $MgmtSvr.
La deuxième commande obtient l’emplacement de l’objet serveur de gestion stocké dans la variable $MgmtSvr.
Exemple 4 : Obtenir l’emplacement d’un pool de ressources
PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool
Cet exemple obtient un emplacement pour le pool de ressources nommé Pool01. La première commande obtient l’objet du pool de ressources pour le pool de ressources nommé Pool01 et stocke l’objet dans la variable $Pool.
La deuxième commande obtient l’emplacement du pool stocké dans la variable $Pool.
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 les 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 d’accès aux données System Center doit être en cours d’exécution sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion actuelle au groupe d’administration.
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 |
-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, 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 |
-DisplayName
Spécifie un tableau de noms d’affichage. Les valeurs de ce paramètre dépendent des packs d’administration localisés que vous importez et des paramètres régionaux de l’utilisateur qui exécute Windows PowerShell.
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
FromDisplayName
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Id
Spécifie un tableau d’ID uniques d’emplacements.
Propriétés du paramètre
| Type: | Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromEMOIdParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ManagementServer
Spécifie un tableau d’objets du serveur de gestion. Pour obtenir un objet serveur de gestion, 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 |
-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 |
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.