Partager via


Update-SCSMConnector

Met à jour les propriétés d'un connecteur Service Manager.

Syntax

Update-SCSMConnector
      [-Connector] <Connector[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Update-SCSMConnector met à jour les propriétés d’un connecteur Service Manager. Par exemple, vous pouvez définir la propriété Enable sur $False pour désactiver le connecteur, ou vous pouvez le définir sur $True pour activer le connecteur. Utilisez cette applet de commande conjointement avec l’applet de commande Get-SCSMConnector. Une fois Get-SCSmConnector récupéré l’objet, vous pouvez modifier les propriétés de l’objet, puis le transmettre à l’applet de commande actuelle. Cette applet de commande met à jour les propriétés.

La propriété de planification n’est disponible que si vous avez appliqué Service Manager correctif cumulatif R2 R2 6 ou version ultérieure.

Pour chaque type de connecteur, vous pouvez mettre à jour les propriétés suivantes :

Connecteur Active Directory

  • Description
  • Activer
  • Nom
  • RunAsAccount
  • SelectedObjects
  • Planifier

Connecteur Configuration Manager

  • Collections
  • Description
  • Activer
  • Nom
  • RunAsAccount
  • Planifier

Connecteur d'alerte Operations Manager

  • CloseAlert
  • Description
  • Activer
  • Nom
  • ResolveIncident
  • Règles
  • RunAsAccount
  • Planifier
  • Modèle

Connecteur CI Operations Manager

  • Description
  • Activer
  • Nom
  • OperationsManagerServer
  • RunAsAccount
  • Planifier

Exemples

Exemple 1 : Mettre à jour des objets dans un connecteur Active Directory

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> $ADConnector = Get-SCSMConnector -Name "WOODGROVE Active Directory"
PS C:\> $ADConnector.Select = "(&(objectCategory=computer)(name=*fulle*))"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector

Cet exemple met à jour les objets sélectionnés d’un connecteur Active Directory. La première commande obtient un compte d’identification, à l’aide de l’applet de commande Get-SCSMRunAsAccount, puis la stocke dans la variable $RunAsAccount.

La deuxième commande obtient un connecteur à l’aide de l’applet de commande Get-SCSMConnector , puis la stocke dans la variable $ADConnector.

La troisième commande affecte une valeur à la propriété Select de $ADConnector.

La commande finale obtient tous les connecteurs, puis transmet ceux qui utilisent le $RunAsAccount comme compte d’identification à l’applet de commande active. Cette applet de commande met à jour les connecteurs.

Exemple 2 : Mettre à jour le compte d’identification pour les connecteurs

PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -RunAsProfileName "NewProfile"
PS C:\> Get-SCSMConnector | ForEach-Object { $_.RunAsAccount = $RunAsAccount } | Update-SCSMConnector

La première commande obtient le compte d’identification qui a le nom de profil NewProfile, puis stocke le résultat dans la variable $RunAsAccount.

La deuxième commande met à jour tous les connecteurs qui ont le compte d’identification de $RunAsAccount.

Exemple 3 : Mettre à jour un connecteur d’alerte Operations Manager

PS C:\>$AlertConnector = Get-SCSMConnector "Alert Connector"
PS C:\>$AlertConnector.rules += New-SCSMAlertRule @{
>> Name = "newRule"
>> Template = Get-SCSMObjectTemplate -Name ".*IncidentTemplate.*"
>> ManagementPack = Get-SCManagementPack "System.Library"
>>}
PS C:\>Update-SCSMConnector -Connector $AlertConnector

Cet exemple montre comment ajouter une nouvelle règle à un connecteur d’alerte Operations Manager. La première commande obtient un connecteur, puis la stocke dans la variable $AlertConnector.

La deuxième commande ajoute une règle à la propriété de règles de $AlertConnector. L’applet de commande New-SCSMAlertRule crée la règle. La commande s’étend sur plusieurs lignes.

La commande finale met à jour le connecteur à la valeur actuelle de $AlertConnector.

Paramètres

-Confirm

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

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Connector

Spécifie un objet représentant un connecteur Service Manager.

Type:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Indique que cette applet de commande retourne le connecteur qu’il met à jour. Vous pouvez transmettre cet objet à d’autres applets de commande.

Type:System.Management.Automation.SwitchParameter
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:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector

Vous pouvez diriger un connecteur vers le paramètre Connecteur .

Sorties

None.

Cette applet de commande ne génère aucune sortie.