Cmdlets de maintenance planifiée
Voici la liste des commandes servant à planifier la maintenance des événements.
Les arguments en gras sont obligatoires.
Disable-AmcSchedule
Désactive une planification de maintenance.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
JobId (String) | ID numérique de la tâche à désactiver. |
Enable-AmcSchedule
Active une planification de maintenance.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
JobId (String) | ID numérique de la tâche à activer. |
Get-AmcSchedule
Récupère une seule maintenance planifiée, à partir d'un ID de tâche.
Valeur de retour : MaintenanceHelper.SchedulesDto
Arguments | Description de l'argument |
---|---|
JobId (String) | ID numérique de la tâche à récupérer. |
Invoke-AmcRemoveEventsFromDeploymentGroup
Supprime les événements du groupe de déploiement spécifié.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
GroupName (String) | Nom du groupe de déploiement dont vous voulez supprimer les événements. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Invoke-AmcRemoveEventsOlderThan
Supprime les événements dont l'âge dépasse le nombre de jours indiqué.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Days (String) | Nombre de journées d'événements à conserver. Tous les événements plus anciens sont supprimés. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Invoke-AmcRemoveEventsWithId
Supprime les événements portant l'ID spécifié.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
EventId (String) | ID d'événement à supprimer de la base de données. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Invoke-AmcRemoveEventsWithIdRange
Supprime tous les événements figurant dans la plage d'ID spécifiée.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
EndEventId (String) | ID de fin de la plage d'ID d'événement. |
StartEventId |
ID de début de la plage d'ID d'événement. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Invoke-AmcRemovehighVolumeEventsOlderThan
Supprime tous les événements à fort volume dont l'âge dépasse le nombre de jours indiqué.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Days (String) | Âge maximal des événements à fort volume à conserver. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Invoke-AmcRemoveOrphanedAlerts
Supprime toutes les alertes qui ne sont associées à aucun événement.
La commande d'appel de planification (invoke schedule) crée une planification temporaire du type spécifié, qui s'exécute immédiatement, puis se supprime.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Remove-AmcSchedule
Supprime une planification portant l'ID de tâche spécifié.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
JobId (String) | ID numérique de la tâche à supprimer, tel qu'indiqué par Get-AmcSchedules |
Set-AmcEncryptionKeyHash
Génère le hachage de clé de cryptage AMC. Ce hachage sert à surveiller la clé de cryptage utilisée pour stocker les références d'authentification dans la base de données.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Stop-AmcSchedule
Annule la planification spécifiée.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
JobId (String) | ID numérique de la tâche à annuler. |
New-AmcScheduleRemoveEventsFromDeploymentGroup
Ajoute une nouvelle planification pour supprimer des événements du groupe de déploiement spécifié, le jour indiqué chaque semaine.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
GroupName (String) | Nom du groupe de déploiement dont vous voulez supprimer les événements. |
Description (String) | Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) | Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) | Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) | Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) | Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) | Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
New-AmcScheduleRemoveEventsOlderThan
Ajoute une nouvelle planification pour supprimer les événements dont l'âge dépasse le nombre de jours indiqué.
Valeur renvoyée : Void (vide)
Arguments |
Description de l'argument |
---|---|
Days (Int) |
Âge maximal des événements à conserver. |
Description (String) |
Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) |
Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) |
Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) |
Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) |
Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
New-AmcScheduleRemoveEventsWithId
Crée une entrée de tâche planifiée pour supprimer tous les événements portant l'ID spécifié.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
EventId (Int) | ID numérique de journal d'événements pour les événements à supprimer |
Description (String) | Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) | Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) | Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) | Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) | Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) | Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
New-AmcScheduleRemoveEventsWithIdRange
Ajoute une nouvelle planification pour supprimer les événements d'une plage de valeurs particulière de tous les groupes de déploiement spécifiés, le jour indiqué chaque semaine.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
StartEventId (Int) | ID numérique de journal d'événements correspondant au début de la plage de valeurs à supprimer |
EndEventId (Int) | ID numérique de journal d'événements correspondant à la fin de la plage de valeurs à supprimer |
Description (String) | Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) | Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) | Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) | Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) | Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) | Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
New-AmcScheduleRemoveHighVolumeEventsOlderThan
Ajoute une nouvelle planification pour supprimer tous les événements à fort volume dont l'âge dépasse le nombre de jours indiqué.
Valeur renvoyée : Void (vide)
Arguments |
Description de l'argument |
---|---|
Days (Int) |
Âge maximal des événements à conserver. |
Description (String) |
Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) |
Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) |
Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) |
Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) |
Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
New-AmcScheduleRemoveOrphanedAlerts
Ajoute une nouvelle planification pour supprimer toutes les alertes qui ne sont associées à aucun événement.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Description (String) | Texte libre. Ce champ permet à l'administrateur de spécifier l'objectif de l'entrée planifiée, ainsi que tout autre détail de son choix. |
DayOfWeek (DayOfWeek) | Jour de chaque semaine où l'action doit être exécutée. La valeur de ce champ va de zéro (dimanche) à six (samedi). |
StartTimeInUTC (String) | Chaîne représentant l'heure du jour au format UTC à laquelle l'action demandée doit commencer. Doit pouvoir être analysé en valeur .Net System.DateTime. |
MaxRunHours (Int) | Durée pendant laquelle l'action doit s'exécuter. Même si la tâche commence en retard (par exemple, parce que la machine est éteinte), l'heure de fin est toujours StartTimeInUTC + MaxRunHours. |
BatchSize (Int) | Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
BatchDelay (TimeSpan) | Délai en secondes que SQL respecte pour permettre le traitement des autres transactions, afin d'éviter que les transactions se bloquent mutuellement. |
Publish-AmcEncryptionKey
AMC utilise une clé de cryptage pour stocker en toute sécurité les informations sensibles (comme les références d'authentification d'accès des clients) dans la base de données AMC.Pour que plusieurs serveurs lisent dans la même base de données, cette clé doit être synchronisée.
Cette commande envoie en mode Push la clé de cryptage AMC locale à la base de données connectée, pour que les autres serveurs de gestion se synchronisent dessus.
Pour effectuer la synchronisation avec cette clé sur les autres serveurs, vous pouvez utiliser la commande Sync-AmcEncryptionKey. La clé est cryptée avec le paramètre indiqué et la stocke dans la base de données. Vous devez supprimer cette clé avec Unpublish-AmcEncryptionKey une fois tous les serveurs synchronisés.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Password (String) | Vous utilisez un mot de passe (Password) pour sécuriser la référence d'authentification pour son stockage dans la base de données. Vous aurez besoin du même mot de passe pour récupérer la clé sur un autre serveur. |
Secure Password (String) | Vous utilisez un mot de passe (Password) pour sécuriser la référence d'authentification pour son stockage dans la base de données. Vous aurez besoin du même mot de passe pour récupérer la clé sur un autre serveur. |
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Sync-AmcEncryptionKey
AMC utilise une clé de cryptage pour stocker en toute sécurité les informations sensibles (comme les références d'authentification d'accès des clients) dans la base de données AMC.Pour que plusieurs serveurs lisent dans la même base de données, cette clé doit être synchronisée.
Cette commande récupère (Pull) une clé de cryptage stockée depuis une base de données AMC et l'utilise sur le serveur local.Vous pouvez publier une clé depuis un autre serveur avec la commande Publish-AmcEncryptionKey. Vous devez supprimer cette clé avec Unpublish-AmcEncryptionKey une fois tous les serveurs synchronisés.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Password (String) | Ce mot de passe (Password) sert à lire la clé cryptée dans la base de données. Vous devrez utiliser le même mot de passe que celui utilisé pour la commande de publication (Publish). |
Secure Password (String) | Ce mot de passe (Password) sert à lire la clé cryptée dans la base de données. Vous devrez utiliser le même mot de passe que celui utilisé pour la commande de publication (Publish). |
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Unpublish-AmcEncyptionKey
AMC utilise une clé de cryptage pour stocker en toute sécurité les informations sensibles (comme les références d'authentification d'accès des clients) dans la base de données AMC.Pour que plusieurs serveurs lisent dans la même base de données, cette clé doit être synchronisée.
Cette commande supprime la clé de cryptage AMC de la base de données connectée, une fois que les autres serveurs de gestion sont synchronisés.La clé reste stockée en mode sécurisé sur chaque serveur mais elle disparaît de la base de données.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Test-AmcEncryptionKey
AMC utilise une clé de cryptage pour stocker en toute sécurité les informations sensibles (comme les références d'authentification d'accès des clients) dans la base de données AMC.Pour que plusieurs serveurs lisent dans la même base de données, cette clé doit être synchronisée.
Vous pouvez stocker une clé dans la base de données pour la synchronisation de tous les serveurs. Cette commande vérifie si une clé est disponible.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Test-AmcEncryptionKeyHash
Compare le hachage avec la clé de cryptage. Si le hachage n'existe pas, il est créé. Si la commande renvoie false (faux), la clé de cryptage a changé et les références d'authentification client stockées dans la base de données sont disponibles.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Références d'authentification de configuration | Références d'authentification que le cmdlet utilise pour apporter des changements dans la base de données. Si ce paramètre est omis, le cmdlet utilise la référence d'authentification de l'utilisateur. |
Authentification SQL pour la configuration (Commutateur) | Lorsque vous spécifiez ce commutateur, les références d'authentification fournie sous Références d'authentification de configuration sont définies comme références d'authentification SQL. Si ce paramètre est omis, les références d'authentification de configuration sont considérées comme des références d'authentification Windows. |
Serveur de base de données | Serveur SQL Server qui héberge la base de données. |
Nom de base de données | Nom de la base de données du serveur SQL Server. |
Test-AmcRemoveEventsFromDeploymentGroup
Renvoie le nombre d'événements à supprimer du groupe de déploiement spécifié.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
GroupName (String) |
Nom du groupe de déploiement où vous voulez supprimer des événements. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Test-AmcRemoveEventsOlderThan
Renvoie le nombre d'événements à supprimer dont l'âge dépasse le nombre de jours indiqué.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Days (String) |
Nombre de journées d'événements à conserver. Tous les événements plus anciens sont supprimés. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Test-AmcRemoveEventsWithId
Renvoie le nombre d'événements à supprimer qui portent l'ID spécifié.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
EventId(String) |
ID d'événement à supprimer de la base de données. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Test-AmcRemoveEventsWithIdRange
Renvoie le nombre d'événements à supprimer qui figurent dans la plage d'ID d'événement spécifiée.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
EndEventId (String) |
ID de fin de la plage d'ID d'événement à supprimer de la base de données. |
StartEventId (String) |
ID de début de la plage d'ID d'événement à supprimer de la base de données. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Test-AmcRemoveHighVolumeEventsOlderThan
Renvoie le nombre d'événements à supprimer qui sont des événements à fort volume dont l'âge dépasse le nombre de jours indiqué.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Days (String) |
Âge maximal des événements à fort volume à conserver. |
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Test-AmcRemoveOrphanedAlerts
Renvoie le nombre d'alertes qui ne sont associées à aucun événement à supprimer.
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
BatchDelay |
Délai en millisecondes que SQL respecte pour permettre le traitement des transactions. |
BatchSize |
Nombre de lignes qui doivent être affectées dans chaque transaction de batch. |
Update-AmcSchedule
Met à jour une seule maintenance planifiée à partir de l'objet Planification spécifié. Vous obtenez cet objet avec la commande Get-AmcSchedule.
Les propriétés pouvant être mises à jour sont les suivantes :
- Description
- StartTimeInUTC
- Paramètres
- StartDayOfWeek
- MaxRunHours
- BatchSize
- BatchDelayMs
Valeur renvoyée : Void (vide)
Arguments | Description de l'argument |
---|---|
Schedule (MaintenanceHelper.SchedulesDto) |
Objet Planification qui stocke les paramètres pour la maintenance planifiée. |