Partager via

New-SCOMLocation

  • Référence
Module:
OperationsManager

Crée un emplacement auquel vous pouvez affecter des ordinateurs gérés par l’agent, des serveurs d’administration ou des pools de ressources.

Syntaxe

New-SCOMLocation
   [-DisplayName] <String>
   -Latitude <String>
   -Longitude <String>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet New-SCOMLocation crée un emplacement. Vous pouvez associer des ordinateurs gérés par l’agent, des serveurs d’administration ou des pools de ressources à un emplacement à l’aide de l’applet de commande Set-SCOMLocation. Le tableau de bord récapitulatif de la surveillance de la disponibilité des applications web affiche les éléments que vous associez à un emplacement.

Indiquez un nom complet, une latitude et une longitude pour votre emplacement. Utilisez l’applet de commande Update-SCOMLocation pour apporter des modifications à un emplacement, ou utilisez le Remove-SCOMLocation pour supprimer un emplacement.

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 : Créer un emplacement

PS C:\>New-SCOMLocation -DisplayName "Seattle, WA" -Latitude 47.6063889 -Longitude -122.330833

Cette commande crée un emplacement dont le nom d’affichage est Seattle, WA. La commande spécifie la latitude et la longitude de Seattle.

Paramètres

-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

-DisplayName

Spécifie un nom complet pour l’emplacement.

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

-Latitude

Spécifie une valeur de latitude pour l’emplacement en degrés décimaux.

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

-Longitude

Spécifie une valeur de longitude pour l’emplacement en degrés décimaux.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
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