Partager via

Remove-SCOMLocation

  • Référence
Module:
OperationsManager

Supprime les associations avec un emplacement ou supprime un emplacement.

Syntaxe

Remove-SCOMLocation
      [-Agent] <AgentManagedComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-ManagementServer] <ManagementServer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Pool] <ManagementServicePool[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Location] <EnterpriseManagementObject[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-SCOMLocation supprime l’association d’un emplacement à un ordinateur géré par un agent, un serveur d’administration ou un pool de ressources, ou supprime un emplacement. Pour supprimer une association, spécifiez des ordinateurs gérés par l’agent, des serveurs d’administration ou des pools de ressources. Pour supprimer un emplacement, spécifiez l’emplacement à l’aide de l’applet de commande Get-SCOMLocation .

Vous pouvez modifier un nom d’affichage d’emplacement, une latitude ou une longitude à l’aide de l’applet de commande Update-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 : Supprimer un emplacement

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location

Cet exemple montre comment supprimer un emplacement dont le nom d’affichage est Seattle, WA. La première commande obtient l’objet d’emplacement qui a le nom d’affichage Seattle, WA, puis stocke l’objet dans la variable $Location.

La deuxième commande supprime l’objet d’emplacement stocké dans la variable $Location.

Exemple 2 : Supprimer un ordinateur géré par un agent à partir d’un emplacement

PS C:\>$Agent = Get-SCOMAgent -Name "Server73.Contoso.com"
PS C:\> Remove-SCOMLocation -Agent $Agent

Cet exemple supprime un ordinateur géré par un agent nommé Server73.Contoso.com de son emplacement. La première commande obtient l’objet agent pour l’ordinateur nommé Server73.Contoso.com, puis stocke l’objet dans la variable $Agent.

La deuxième commande supprime l’association d’emplacement de l’objet ordinateur géré par l’agent stocké dans la variable $Agent. Cette commande ne supprime pas l’emplacement lui-même.

Exemple 3 : Supprimer un serveur d’administration d’un emplacement

PS C:\>$MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Remove-SCOMLocation -ManagementServer $MgmtServer

Cet exemple supprime un serveur d’administration de son emplacement. La première commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com, puis stocke l’objet dans la variable $MgmtServer.

La deuxième commande supprime l’association d’emplacement de l’objet serveur d’administration stocké dans la variable $MgmtServer. Cette commande ne supprime pas l’emplacement lui-même.

Exemple 4 : Supprimer un pool de ressources d’un emplacement

PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool

Cet exemple supprime un pool de ressources nommé Notifications Resource Pool de son emplacement. La première commande obtient l’objet pool de ressources d’un pool de ressources nommé Pool de ressources notifications, puis stocke l’objet dans la variable $Pool.

La deuxième commande supprime l’association d’emplacement de l’objet de pool de ressources stocké dans la variable $Pool. Cette commande ne supprime pas l’emplacement lui-même.

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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
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

-Location

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

Type:EnterpriseManagementObject[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 .

Type:ManagementServer[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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