Remove-SCOMLocation

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>]

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.

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.

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.

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.

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.

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.