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.