Update-SCSMConnector
Met à jour les propriétés d’un connecteur Service Manager.
Syntaxe
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 la définir sur $True pour activer le connecteur. Utilisez cette applet de commande conjointement avec l’applet de commande Get-SCSMConnector. Une fois que Get-SCSmConnector a 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é schedule n’est disponible que si vous avez appliqué Service Manager 2012 R2 Update Rollup 6 ou version ultérieure.
Pour chaque type de connecteur, vous pouvez mettre à jour les propriétés suivantes :
Connecteur Active Directory
- Descriptif
- Activer
- Nom
- RunAsAccount
- SelectedObjects
- Calendrier
Connecteur Configuration Manager
- Collections
- Descriptif
- Activer
- Nom
- RunAsAccount
- Calendrier
Connecteur d’alerte Operations Manager
- FermerAlerte
- Descriptif
- Activer
- Nom
- RésoudreIncident
- Règles
- RunAsAccount
- Calendrier
- Modèle
Connecteur CI Operations Manager
- Descriptif
- Activer
- Nom
- OperationsManagerServeur
- RunAsAccount
- Calendrier
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 le stocke dans la variable $RunAsAccount.
La deuxième commande obtient un connecteur à l’aide de l’applet de commande Get-SCSMConnector , puis le stocke dans la variable $ADConnector.
La troisième commande attribue une valeur à la propriété Select de $ADConnector.
La commande finale récupère tous les connecteurs, puis transmet ceux qui utilisent le $RunAsAccount en tant que compte d’identification à l’applet de commande actuelle. 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 récupère le compte d’identification portant 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 ajoute une nouvelle règle à un connecteur d’alerte Operations Manager. La première commande récupère un connecteur, puis le stocke dans la variable $AlertConnector.
La deuxième commande ajoute une règle à la propriété rules 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 invite à confirmer avant d’exécuter l’applet de commande.
Type: | System.Management.Automation.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 |
-Connector
Spécifie un objet qui représente un connecteur Service Manager.
Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector[] |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-PassThru
Indique que cette applet de commande retourne le connecteur qu’elle met à jour. Vous pouvez passer cet objet à d’autres applets de commande.
Type: | System.Management.Automation.SwitchParameter |
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 ne s’exécute pas.
Type: | System.Management.Automation.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 |
Entrées
Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.Connector
Vous pouvez rediriger un connecteur vers le paramètre Connector .
Sorties
None.
Cette applet de commande ne génère aucune sortie.