Partager via

Remove-SCOMLocation

  • Référence
Module:
OperationsManager

Supprime les associations avec un emplacement ou supprime un emplacement.

Syntax

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

L’applet de commande Remove-SCOMLocation supprime l’association d’un emplacement avec un ordinateur géré par l’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, voir 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 supprime un emplacement qui porte le nom complet Seattle, WA. La première commande obtient l’objet d’emplacement qui a le nom complet 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é Notifications Resource Pool, 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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, voir 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

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

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

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

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False