PowerShell


Management

Cette section contient les rubriques d'aide pour les applets de commande installées avec le module PowerShell Microsoft.PowerShell.Management. Le module Management contient des applets de commande qui vous aident à gérer Windows dans PowerShell.

Management

Add-Computer

Ajoutez l'ordinateur local à un domaine ou un groupe de travail.

Syntaxe

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-UnjoinDomainCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-DomainName] <String>
   [-OUPath <String>]
   [-Server <String>]
   [-Unsecure]
   [-Options <JoinOptions>]
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-WorkgroupName] <String>
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

La cmdlet Add-Computer ajoute l'ordinateur local ou les ordinateurs distants à un domaine ou groupe de travail, ou les déplace d'un domaine à un autre. Elle crée également un compte de domaine si l'ordinateur est ajouté à un domaine sans compte.

Vous pouvez utiliser les paramètres de cette applet de commande pour spécifier une unité organisationnelle (OU) et un contrôleur de domaine ou pour effectuer une jointure non sécurisée.

Exemples

Exemple 1: Ajouter un ordinateur local à un domaine puis redémarrer l'ordinateur

Add-Computer -DomainName Domain01 -Restart

Cette commande ajoute l'ordinateur local au domaine Domain01, puis redémarre l'ordinateur pour rendre le changement effectif.

Exemple 2: Ajouter un ordinateur local à un groupe de travail

Add-Computer -WorkgroupName WORKGROUP-A

Cette commande ajoute l'ordinateur local au groupe de travail WORKGROUP-A.

Exemple 3: Ajouter un ordinateur local à un domaine

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Cette commande ajoute l'ordinateur local au domaine Domain01 en utilisant le contrôleur de domaine Domain01\DC01.

La commande utilise les paramètres PassThru et Verbose pour obtenir des informations détaillées sur le résultats de la commande.

Exemple 4: Ajouter un ordinateur local à un domaine en utilisant le paramètre OUPath

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Cette commande ajoute l'ordinateur local au domaine Domain02. Elle utilise le paramètre OUPath pour spécifier l'unité organisationnelle pour les nouveaux comptes.

Exemple 5: Ajouter un ordinateur local à un domaine à l'aide d'informations d'identification

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

Cette commande ajoute l'ordinateur Server01 au domaine Domain02. Elle utilise le paramètre LocalCredential pour spécifier un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur Server01. Elle utilise le paramètre Credential pour spécifier un compte d'utilisateur qui a l'autorisation de joindre des ordinateurs au domaine. Elle utilise le paramètre Restart pour redémarrer l'ordinateur une fois l'opération de jointure terminée et le paramètre Force pour supprimer les messages de confirmation de l'utilisateur.

Exemple 6: Déplacer un groupe d'ordinateurs vers un nouveau domaine

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande déplace les ordinateurs Server01 et Server02 et l'ordinateur local de Domain01 à Domain02.

Elle utilise le paramètre LocalCredential pour spécifier un compte utilisateur autorisé à se connecter aux trois ordinateurs concernés. Elle utilise le paramètre UnjoinDomainCredential pour spécifier un utilisateur compte qui a l'autorisation de dissocier les ordinateurs du domaine Domain01 et le paramètre Credential pour spécifier un compte d'utilisateur qui a l'autorisation de joindre les ordinateurs au domaine Domain02. Elle utilise le paramètre Restart pour redémarrer les trois ordinateurs une fois le déplacement terminé.

Exemple 7: Déplacer un ordinateur vers un nouveau domaine et changer le nom de l'ordinateur

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande déplace l'ordinateur Server01 vers le Domain02 et modifie le nom de l'ordinateur en Server044.

La commande utilise les informations d'identification de l'utilisateur actuel pour se connecter à l'ordinateur Server01 et se déconnecter de son domaine actuel. Elle utilise le paramètre Credential pour spécifier un compte utilisateur qui a la permission de joindre l'ordinateur au domaine Domain02.

Exemple 8: Ajouter des ordinateurs répertoriés dans un fichier à un nouveau domaine

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande ajoute les ordinateurs qui sont répertoriés dans le fichier Servers.txt au domaine Domain02. Elle utilise le paramètre Options pour spécifier l'option Win9xUpgrade. Le paramètre Restart redémarre tous les ordinateurs nouvellement ajoutés une fois l'opération de jointure terminée.

Exemple 9 : Ajouter un ordinateur à un domaine avec un nouveau nom

L'utilisation de cette combinaison de commandes évite plusieurs redémarrages et plusieurs écritures dans Active Directory pour le même objet lorsque l'ordinateur joint le domaine avec le nouveau nom.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

Paramètres

-ComputerName

Spécifie les ordinateurs à ajouter à un domaine ou groupe de travail. La valeur par défaut est l'ordinateur local.

Tapez le nom NetBIOS, une adresse Internet Protocol (IP) ou un nom de domaine complet pour chacun des ordinateurs distants. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.), ou "localhost".

Ce paramètre ne repose pas sur la mise à distance de Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Add-Computer même si votre ordinateur n'est pas configuré pour exécuter des commandes à distance.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-Credential

Spécifie un compte d'utilisateur qui a l'autorisation de joindre les ordinateurs à un nouveau domaine. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que "User01" ou "Domain01\User01", ou entrez un objet PSCrédentiel, tels qu'un produit généré par l'applet Get-Credential. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.

Pour spécifier un compte d'utilisateur autorisé à supprimer l'ordinateur de son domaine actuel, utilisez le paramètre  UnjoinDomainCredential. Pour spécifier un compte d'utilisateur autorisé à se connecter sur un ordinateur distant, utilisez le paramètreLocalCredential.

-DomainName

Spécifie le domaine auquel les ordinateurs sont ajoutés. Ce paramètre est requis lors de l'ajout de ordinateurs vers un domaine.

-Force

Supprime l'invite de confirmation de l'utilisateur. Sans ce paramètre, Add-Computer vous oblige à confirmez l'ajout de chaque ordinateur.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-LocalCredential

Spécifie un compte d'utilisateur qui a l'autorisation de se connecter aux ordinateurs spécifiés par le paramètre ComputerName. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que "User01" ou "Domain01\User01", ou entrez un objet PSCredential, tels qu'un produit généré par l'applet Get-Credential. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.

Pour spécifier un compte d'utilisateur qui a l'autorisation d'ajouter les ordinateurs à un nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte utilisateur autorisé à supprimer les ordinateurs leur domaine actuel, utilisez le paramètre UnjoinDomainCredential.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-NewName

Spécifie un nouveau nom pour l'ordinateur dans le nouveau domaine. Ce paramètre est valide uniquement lorsqu'un l'ordinateur est ajouté ou déplacé.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-Options

Spécifie les options avancées pour Add-Computer. Entrez une ou plusieurs valeurs dans une chaîne séparée par des virgules.

Les valeurs acceptables pour ce paramètre sont:

Ce paramètre a été introduit dans Windows PowerShell 3.0.

-OUPath

Spécifie une unité organisationnelle (OU) pour le compte de domaine. Entrez le nom distinctif complet de l'OU entre guillemets. La valeur par défaut est l'OU par défaut pour les objets machine du domaine.

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette cmdlet ne génère aucune sortie.

-Restart

Redémarre les ordinateurs ajoutés au domaine ou au groupe de travail. Un redémarrage est souvent nécessaire pour rendre le changement effectif.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-Server

Spécifie le nom d'un contrôleur de domaine qui ajoute l'ordinateur au domaine. Entrez le nom au format DomainName\ComputerName. Par défaut, aucun contrôleur de domaine n'est spécifié.

-UnjoinDomainCredential

Spécifie un compte d'utilisateur qui a l'autorisation de supprimer les ordinateurs de leurs domaines actuels. Le la valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que "User01" ou "Domain01\User01", ou entrez un objet PSCrédentiel, tels qu'un produit généré par l'applet Get-Credential. Si vous tapez un nom d'utilisateur, vous serez invité à saisir un mot de passe.

Utilisez ce paramètre lorsque vous déplacez des ordinateurs vers un autre domaine. Pour spécifier un compte utilisateur qui a l'autorisation de rejoindre le nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte d'utilisateur autorisé à se connecter à un ordinateur distant, utilisez le paramètre LocalCredential.

Ce paramètre est introduit dans Windows PowerShell 3.0.

-Unsecure

Effectue une jointure non sécurisée au domaine spécifié.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

-WorkgroupName

Spécifie le nom d'un groupe de travail auquel les ordinateurs sont ajoutés. La valeur par défaut est "WORKGROUP".

Management

Rename-Computer

Renomme un ordinateur.

Syntaxe

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

La cmdlet Rename-Computer renomme l'ordinateur local ou un ordinateur distant. Elle renomme un ordinateur à chaque commande.

Cette applet de commande a été introduite dans Windows PowerShell 3.0.

Exemples

Exemple 1: Renommer l'ordinateur local

Cette commande renomme l'ordinateur local en Server044 et redémarre pour appliquer le changement.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

Exemple 2: Renommer un ordinateur distant

Cette commande renomme l'ordinateur Srv01 en Server001. L'ordinateur n'est pas redémarré.

Le paramètre DomainCredential spécifie les informations d'identification d'un utilisateur autorisé à renommer ordinateurs dans le domaine.

Le paramètre Force supprime l'invite de confirmation.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Paramètres

-ComputerName

Renomme l'ordinateur distant spécifié. La valeur par défaut est l'ordinateur local.

Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.), ou localhost.

Ce paramètre ne repose pas sur la télécommande PowerShell. Vous pouvez utiliser le ComputerName paramètre de Rename-Computer même si votre ordinateur ne l'est pas configuré pour exécuter des commandes distantes.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-DomainCredential

Spécifie un compte d'utilisateur qui a l'autorisation de se connecter au domaine. Des informations d'identification explicites sont nécessaires pour renommer un ordinateur joint à un domaine.

Saisissez un nom d'utilisateur, tel que User01 ou Domain01\User01, ou entrez un PSCrédentiel objet, tel comme celui généré par le Get-Credential applet.

Si vous tapez un nom d'utilisateur, cette applet de commande vous demande un mot de passe.

Pour spécifier un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur spécifié par le ComputerName paramètre, utilisez le LocalCrédentiel paramètre.

-Force

Force la commande à s'exécuter sans demander la confirmation de l'utilisateur.

-LocalCredential

Spécifie un compte d'utilisateur qui a l'autorisation de se connecter à l'ordinateur spécifié par le ComputerName paramètre. La valeur par défaut est l'utilisateur actuel.

Saisissez un nom d'utilisateur, tel que User01 ou Domain01\User01, ou entrez un PSCrédentiel objet, tels que un produit généré par le Get-Credential applet.

Si vous tapez un nom d'utilisateur, cette applet de commande vous demande un mot de passe.

Pour spécifier un compte d'utilisateur autorisé à se connecter au domaine, utilisez le DomainCredential paramètre.

-NewName

Spécifie un nouveau nom pour l'ordinateur. Ce paramètre est requis.

Les noms standards peuvent contenir des lettres (a-z(), (A-Z), chiffres (0-9), et tirets (-), mais non espaces ou périodes (.'). Le nom peut ne pas être entièrement composé de chiffres et ne pas être plus long que 63 Caractères

-PassThru

Renvoie les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.

-Protocol

Spécifie le protocole à utiliser pour renommer l'ordinateur. Les valeurs acceptables pour ce paramètre sont: WSMan et DCOM. La valeur par défaut est DCOM.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

-Restart

Indique que cette applet de commande redémarre l'ordinateur qui a été renommé. Un redémarrage est souvent nécessaire pour rendre le changement efficace.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

-WsmanAuthentication

Spécifie le mécanisme utilisé pour authentifier les informations d'identification de l'utilisateur lorsque cette applet de commande utilise le WSMan protocole. Les valeurs acceptables pour ce paramètre sont:

La valeur par défaut est Défaut.

Authentification Credential Security Service Provider (CredSSP), dans laquelle l'utilisateur les informations d'identification sont transmises à un ordinateur distant pour être authentifiées, est conçu pour les commandes qui exiger l'authentification sur plusieurs ressources, comme l'accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité de l'opération à distance. Si l'ordinateur distant est compromis, les informations d'identification qui lui sont transmises peuvent être utilisées pour contrôler > la session réseau.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

PrintManagement

Cette référence fournit des descriptions d'applets de commande et la syntaxe pour toutes les applets de commande de gestion d'impression.

PrintManagement

Add-Printer

Ajoute une imprimante sur l'ordinateur spécifié.

Syntaxe

Add-Printer
   [-ConnectionName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Printer
   [-Comment <String>]
   [-Datatype <String>]
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs]
   [-Location <String>]
   [-SeparatorPageFile <String>]
   [-ComputerName <String>]
   [-Shared]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-Name] <String>
   [-PermissionSDDL <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published]
   [-RenderingMode <RenderingModeEnum>]
   [-DisableBranchOfficeLogging]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-DeviceURL <String>]
   [-DeviceUUID <String>]
   [-IppURL <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Printer
   [-Comment <String>]
   [-Datatype <String>]
   [-DriverName] <String>
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs]
   [-Location <String>]
   [-SeparatorPageFile <String>]
   [-ComputerName <String>]
   [-Shared]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-Name] <String>
   [-PermissionSDDL <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published]
   [-RenderingMode <RenderingModeEnum>]
   -PortName <String>
   [-DisableBranchOfficeLogging]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Le cmdlet Add-Printer ajoute une imprimante sur un ordinateur spécifié. Vous pouvez ajouter des imprimantes locales et des connexions aux imprimantes réseau.

Vous ne pouvez pas utiliser de caractères génériques avec Add-Printer. Vous pouvez utiliser Add-Printer dans une session à distance Windows PowerShell.

Vous pouvez avoir besoin d'informations d'identification Administrateur pour exécuter Add-Printer.

Exemples

Example 1 : Ajouter une imprimante sur l'ordinateur local

Add-Printer -Name "mxdw 2" -DriverName "Microsoft XPS Document Writer v4" -PortName "portprompt:"

Cette commande ajoute une imprimante avec le nom mxdw 2 sur l'ordinateur local. L'imprimante mxdw 2 utilise le pilote Microsoft XPS Document Writer v4 et le port portprompt:.

Example 2 : Ajouter une nouvelle connexion d'imprimante réseau

Add-Printer -ConnectionName \\printServer\printerName

Cette commande ajoute une imprimante en spécifiant le nom d'un serveur d'impression et d'une imprimante partagée sur ce serveur.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-BranchOfficeOfflineLogSizeMB

Spécifie la taille maximale, en mégaoctets, du fichier journal hors ligne distant de la succursale pour cette imprimante. Vous ne pouvez pas spécifier ce paramètre pour les files d'attente non partagées ou les files d'attente qui n'ont pas activé la succursale.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-Comment

Spécifie le texte à ajouter au champ Commentaire pour l'imprimante spécifiée.

-ComputerName

Spécifie le nom de l'ordinateur auquel ajouter l'imprimante.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-ConnectionName

Spécifie le nom d'une imprimante partagée à laquelle se connecter. Ce paramètre est requis.

-Datatype

Spécifie le type de données utilisé par l'imprimante pour enregistrer les travaux d'impression.

-DeviceURL

Spécifie une URL pour la découverte dirigée d'une imprimante Web Services on Devices (WSD) à ajouter sur l'ordinateur spécifié.

-DeviceUUID

Spécifie l'UUID multicast pour la détection de périphérique pour le port WSD.

-DisableBranchOfficeLogging

Indique que la journalisation à distance des succursales est désactivée. Vous ne pouvez pas spécifier ce paramètre pour les files non partagées.

-DriverName

Spécifie le nom du pilote d'imprimante pour l'imprimante.

-IppURL

Spécifie une URL ou un nom d'hôte ou une adresse IP pour la découverte dirigée d'une imprimante IPP (Internet Printing Protocol) à ajouter sur l'ordinateur spécifié.

-KeepPrintedJobs

Spécifie si les tâches d'impression dans la file d'attente sont conservées.

-Location

Spécifie l'emplacement de l'imprimante.

-Name

Spécifie le nom de l'imprimante à ajouter.

-PermissionSDDL

Spécifie les autorisations pour l'imprimante en tant que chaîne Security Descriptor Definition Language (SDDL).

-PortName

Spécifie le nom du port utilisé ou créé pour l'imprimante.

-PrintProcessor

Spécifie le nom du processeur d'impression utilisé par l'imprimante.

-Priority

Spécifie la priorité relative de la file d'attente

-Published

Spécifie si l'imprimante est publiée dans le service d'annuaire réseau.

-RenderingMode

Spécifie le mode de rendu de l'imprimante. Vous pouvez spécifier l'un des modes de rendu suivants:

-SeparatorPageFile

Spécifie le chemin et le nom de la page de séparation à utiliser par l'imprimante.

-Shared

Indique s'il faut partager l'imprimante sur le réseau. Vous pouvez déterminer le nom par lequel l'imprimante est partagée en spécifiant ShareName. Si ShareName n'est pas spécifié, le nom de l'imprimante est utilisé comme nom de partage.

-ShareName

Spécifie le nom par lequel partager l'imprimante sur le réseau. Pour partager une imprimante, spécifiez le paramètre Shared.

-StartTime

Spécifie l'heure de démarrage de la disponibilité de l'imprimante.

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-UntilTime

Spécifie l'heure de fin de la disponibilité de l'imprimante.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

-WorkflowPolicy

Permet à un administrateur d'associer une imprimante donnée à une application Workflow spécifique. Ce paramètre ne permet pas à l'administrateur de remplacer l'association périphérique-application créée à l'aide du service de métadonnées de périphérique.

PrintManagement

Add-PrinterDriver

Installe un pilote d'imprimante sur l'ordinateur spécifié.

Syntaxe

Add-PrinterDriver
   [-Name] <String>
   [[-InfPath] <String>]
   [-PrinterEnvironment <String>]
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Add-PrinterDriver installe un pilote d'imprimante sur l'ordinateur spécifié.

Vous ne pouvez pas utiliser de caractères génériques avec Add-PrinterDriver. Vous pouvez utiliser Add-PrinterDriver dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Add-PrinterDriver.

Exemples

Exemple 1: Ajouter un pilote d'imprimante

Add-PrinterDriver -Name "Driver Name"

Cette commande installe le pilote d'imprimante spécifié par le paramètre Name sur l'ordinateur local.

Exemple 2: Ajouter un pilote d'imprimante sur un ordinateur distant

Add-PrinterDriver -Name "Driver Name" -ComputerName "printServer"

Cette commande installe le pilote d'imprimante spécifié par le paramètre Name sur l'ordinateur distant spécifié par le paramètre ComputerName.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-ComputerName

Spécifie le nom de l'ordinateur auquel ajouter l'imprimante.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-InfPath

Spécifie le chemin du fichier INF du pilote d'imprimante dans le magasin de pilotes. Les fichiers INF contiennent des informations sur l'imprimante et le pilote d'imprimante.

-Name

Spécifie le nom du pilote d'imprimante.

-PrinterEnvironment

Spécifie l'environnement du pilote d'imprimante.

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Add-PrinterPort

Installe un port d'imprimante sur l'ordinateur spécifié.

Syntaxe

Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-SNMP <UInt32>]
   [-SNMPCommunity <String>]
   [-LprHostAddress] <String>
   [-LprQueueName] <String>
   [-LprByteCounting]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-PrinterPort
   [-Name] <String>
   [-ComputerName <String>]
   [-PrinterHostAddress] <String>
   [-PortNumber <UInt32>]
   [-SNMP <UInt32>]
   [-SNMPCommunity <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-PrinterPort
   [-ComputerName <String>]
   [-HostName] <String>
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Add-PrinterPort crée un port d'imprimante sur l'ordinateur spécifié. Vous pouvez créer un port d'imprimante local, un port d'imprimante à l'aide de TCP et des ports d'imprimante LPR en utilisant Add-PrinterPort.

Vous ne pouvez pas utiliser de caractères génériques avec Add-PrinterPort. Vous pouvez utiliser Add-PrinterPort dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Add-PrinterPort.

Exemples

Exemple 1: Créer un port d'imprimante local

Add-PrinterPort -Name "LocalPort:"

Cette commande crée un port d'imprimante local nommé LocalPort sur l'ordinateur local.

Exemple 2: Créer un port d'imprimante TCP

Add-PrinterPort -Name "TCPPort:" -PrinterHostAddress "192.168.100.100"

Cette commande crée un port d'imprimante TCP nommé TCPPort: avec l'adresse IP 192.168.100.100 sur l'ordinateur.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

 

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur auquel ajouter le port de l'imprimante. Si vous ne spécifiez pas de valeur, le port de l'imprimante est ajouté à l'ordinateur local.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-HostName

Spécifie le nom d'hôte de l'ordinateur sur lequel ajouter le port d'imprimante LPR.

 

-LprByteCounting

Indique que cette applet de commande active le comptage d'octets LPR pour un port d'imprimante TCP/IP en mode LPR.

 

-LprHostAddress

Spécifie l'adresse hôte LPR lors de l'installation d'un port d'imprimante TCP/IP en mode LPR.

 

-LprQueueName

Spécifie le nom de file d'attente LPR lors de l'installation d'un port d'imprimante TCP/IP en mode LPR.

 

-Name

Spécifie le nom du port d'imprimante à installer sur l'ordinateur spécifié.

 

-PortNumber

Spécifie le numéro de port TCP/IP pour le port d'imprimante ajouté à l'ordinateur spécifié.

 

-PrinterHostAddress

Spécifie l'adresse hôte du port d'imprimante TCP/IP ajouté à l'ordinateur spécifié.

 

-PrinterName

Spécifie le nom de l'imprimante installée sur le port d'imprimante LPR.

 

-SNMP

Active SNMP et spécifie l'index pour la gestion de port d'imprimante TCP/IP.

 

-SNMPCommunity

Spécifie le nom de communauté SNMP pour la gestion des ports d'imprimante TCP/IP.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

 

 

 

PrintManagement

Get-PrintConfiguration

Obtient les informations de configuration d'une imprimante.

Syntaxe

Get-PrintConfiguration
   [-ComputerName <String>]
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]
Get-PrintConfiguration
   [-PrinterObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-PrintConfiguration obtient les informations de configuration de l'imprimante spécifiée. En utilisant la cmdlet Get-PrintConfiguration, vous pouvez gérer la configuration des fonctionnalités suivantes:

Vous ne pouvez pas utiliser de caractères génériques avec Get-PrintConfiguration. Vous pouvez utiliser Get-PrintConfiguration dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-PrintConfiguration..

Exemples

Exemple 1: Récupérer la configuration de l'imprimante

Get-PrintConfiguration -PrinterName "Microsoft XPS Document Writer"

Cette commande retourne la configuration de l'imprimante nommée "Microsoft XPS Document Writer".

Exemple 2: Obtenir la configuration d'impression pour toutes les imprimantes

$Printers = Get-Printer *
Foreach ($Printer in $Printers){Get-PrintConfiguration -PrinterName $Printer.name}

Cette commande obtient toutes les imprimantes dans une variable $Imprimantes, puis boucle à travers toutes les imprimantes et affiche les propriétés.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les informations de configuration de l'imprimante.

 

-PrinterName

Spécifie le nom de l'imprimante à partir de laquelle récupérer les informations de configuration.

 

-PrinterObject

Spécifie l'objet qui contient l'imprimante à partir de laquelle récupérer les informations de configuration.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

 

PrintManagement

Get-Printer

Récupère une liste des imprimantes installées sur un ordinateur.

Syntaxe

Get-Printer
   [[-Name] <String[]>]
   [-ComputerName <String>]
   [-Full]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-Printer récupère une liste des imprimantes installées sur un ordinateur. Vous pouvez également utiliser Get-Printer pour récupérer les propriétés d'une seule imprimante, puis utiliser ces informations comme entrée dans d'autres applets de commande.

Vous pouvez utiliser des caractères génériques avec Get-Printer. Vous pouvez utiliser Get-Printer dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-Printer.

Exemples

Exemple 1: Obtenir une liste d'imprimantes

Get-Printer

Cette commande récupère une liste d'imprimantes et de connexions d'imprimantes sur l'ordinateur local.

Exemple 2: Obtenir les informations pour une imprimante spécifique

Get-Printer -Name "Microsoft XPS Document Writer"

Cette commande récupère les informations d'une imprimante spécifique nommée Microsoft XPS Document Writer.

Exemple 3: Obtenez les informations détaillées pour une imprimante spécifique

Get-Printer -Name "Microsoft XPS Document Writer" | Format-List

Cette commande récupère des informations détaillées pour une imprimante spécifique nommée Microsoft XPS Document Writer.

Exemple 4: Obtenir une liste d'imprimantes sur un ordinateur distant

Get-Printer -ComputerName PrintServer

Cette commande récupère une liste d'imprimantes à partir de l'ordinateur nommé PrintServer.

Exemple 5: Obtenez une liste d'objets d'imprimante, puis renommez les imprimantes

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
Rename-Printer -InputObject $printer "MXDW"

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer, puis la stocke dans la variable $Printer.

La deuxième commande renomme l'imprimante dans $Printer à l'aide de l'applet de commande Rename-Printer.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les informations de l'imprimante.

 

-Full

Spécifie tous les paramètres d'imprimante à récupérer, y compris RenderingMode et PermissionSDDL.

 

-Name

Spécifie le nom de l'imprimante sur laquelle récupérer les informations.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

PrintManagement

Get-PrinterDriver

Récupère la liste des pilotes d'imprimante installés sur l'ordinateur spécifié.

Syntaxe

Get-PrinterDriver
   [[-Name] <String[]>]
   [-PrinterEnvironment <String[]>]
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-PrinterDriver récupère la liste des pilotes d'imprimante installés sur l'ordinateur spécifié. La cmdlet Get-PrinterDriver renvoie un objet de pilote d'imprimante que vous pouvez stocker dans une variable à utiliser avec d'autres cmdlets. Vous pouvez spécifier le paramètre ComputerName pour lister les pilotes d'imprimante installés sur un autre ordinateur.

Vous pouvez utiliser des caractères génériques avec Get-PrinterDriver. Vous pouvez utiliser Get-PrinterDriver dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-PrinterDriver.

Exemples

Exemple 1 : Obtenez une liste de pilotes d'imprimante utilisant des caractères génériques

Get-PrinterDriver -Name *

Cette commande renvoie une liste des pilotes d'imprimante installés sur l'ordinateur local à l'aide de caractères génériques.

Exemple 2 : Obtenir une liste des pilotes d'imprimante sur un ordinateur distant

Get-PrinterDriver -Name * -ComputerName "PrintServer"

Cette commande récupère une liste de pilotes d'imprimante à partir de l'ordinateur nommé PrintServer.

Exemple 3 : Obtenez des informations détaillées sur chaque pilote

Get-PrinterDriver -Name "Microsoft XPS Document Writer" | Format-List

Cette commande affiche les informations détaillées pour chaque pilote d'imprimante. Get-PrinterDriver affiche une vue résumée de chaque pilote d'imprimante interrogé.

Exemple 4 : Obtenir un objet de pilote d'imprimante

$PrinterDriver = Get-PrinterDriver -Name "Microsoft XPS Document Writer v4"

Cette commande récupère un objet de pilote d'imprimante que vous pouvez utiliser avec d'autres applets de commande. L'objet du pilote d'imprimante est stocké dans la variable $PrinterDriver.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les pilotes d'imprimante.

 

-Name

Spécifie le nom du pilote d'imprimante à récupérer.

 

-PrinterEnvironment

Spécifie l'environnement du pilote d'imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

 

PrintManagement

Get-PrinterPort

Récupère une liste des ports d'imprimante installés sur l'ordinateur spécifié.

Syntaxe

Get-PrinterPort
   [[-Name] <String[]>]
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-PrinterPort récupère une liste des ports d'imprimante installés sur l'ordinateur spécifié.

Vous pouvez utiliser des caractères génériques avec Get-PrinterPort. Vous pouvez utiliser Get-PrinterPort dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-PrinterPort.

Exemples

Exemple 1: Obtenir une liste des ports d'imprimante

Get-PrinterPort

Cette commande récupère une liste de tous les ports d'imprimante installés sur l'ordinateur local.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer la liste des ports de l'imprimante.

 

-Name

Spécifie le nom du port de l'imprimante sur lequel récupérer les informations. Vous pouvez utiliser des caractères génériques pour spécifier le nom du port de l'imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

PrintManagement

Get-PrinterProperty

Récupère les propriétés de l'imprimante pour l'imprimante spécifiée.

Syntaxe

Get-PrinterProperty
   [[-PropertyName] <String[]>]
   [-ComputerName <String>]
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-PrinterProperty récupère une ou plusieurs propriétés d'imprimante pour l'imprimante spécifiée.

Vous ne pouvez pas utiliser de caractères génériques avec Get-PrinterProperty. Vous pouvez utiliser Get-PrinterProperty dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Get-PrinterProperty.

Exemples

Exemple 1: Obtenir les propriétés de l'imprimante

Get-PrinterProperty -PrinterName "Printer name"

Cette commande retourne une liste de propriétés pour l'imprimante spécifiée par le paramètre PrinterName.

Exemple 2: Obtenir les propriétés de l'imprimante pour toutes les imprimantes installées

PS C:\>$printers = get-printer *
foreach ($printer in $printers)
{
    get-printerproperty -printerName $printer.name
}

Cette commande obtient toutes les imprimantes dans une variable $Printers, puis boucle à travers toutes les imprimantes et affiche les propriétés.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les propriétés de l'imprimante.

-PrinterName

Spécifie le nom de l'imprimante à partir de laquelle récupérer les propriétés de l'imprimante.

-PropertyName

Spécifie le nom de la propriété à récupérer.

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

PrintManagement

Get-PrintJob

Récupère une liste de tâches d'impression dans l'imprimante spécifiée.

Syntaxe

Get-PrintJob
   [-ComputerName <String>]
   [-ID <UInt32>]
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Get-PrintJob
   [-ID <UInt32>]
   [-PrinterObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

La cmdlet Get-PrintJob récupère les tâches d'impression actuelles dans l'imprimante spécifiée. Spécifiez le paramètre PrinterName pour lister les travaux d'impression à partir de l'imprimante spécifiée.

Vous ne pouvez pas utiliser de caractères génériques avec Get-PrintJob. Vous pouvez utiliser Get-PrintJob dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Get-PrintJob.

Exemples

Exemple 1: Obtenir une liste des travaux d'impression

Get-PrintJob -PrinterName "PrinterName"

Cette commande récupère une liste de tâches d'impression sur l'imprimante nommée PrinterName.

Exemple 2: Obtenir une liste des travaux d'impression à l'aide d'un objet imprimante

$Printer = Get-Printer -Name "PrinterName:"
Get-PrintJob -PrinterObject $Printer

La première commande obtient une imprimante nommée PrinterName: à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande obtient des travaux d'impression sur l'imprimante dans $Printer.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel récupérer les informations de tâche d'impression.

 

-ID

Spécifie l'ID de la tâche d'impression à récupérer. Vous ne pouvez pas utiliser de caractères génériques.

 

-PrinterName

Spécifie le nom de l'imprimante à partir de laquelle récupérer les informations de travail d'impression.

 

-PrinterObject

Spécifie l'objet imprimante à partir duquel récupérer les informations de tâche d'impression.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

PrintManagement

Remove-Printer

Supprime une imprimante de l'ordinateur spécifié.

Syntaxe

Remove-Printer
      [-Name] <String[]>
      [-ComputerName <String>]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-Printer
      -InputObject <CimInstance[]>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-Printer supprime une imprimante de l'ordinateur spécifié. Vous pouvez spécifier l'imprimante à supprimer en utilisant soit un objet d'imprimante récupéré par Get-Printer, soit en spécifiant un nom d'imprimante.

Vous pouvez utiliser des caractères génériques avec Remove-Printer. Vous pouvez utiliser Remove-Printer dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Remove-Printer.

Exemples

Exemple 1: Supprimer une imprimante spécifique

Remove-Printer -Name "Microsoft XPS Document Writer"

Cette commande supprime l'imprimante nommée Microsoft XPS Document Writer de l'ordinateur local.

Exemple 2: Supprimer une imprimante spécifique à l'aide d'un objet d'imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
Remove-Printer -InputObject $Printer

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande supprime l'imprimante dans $Printer.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel retirer l'imprimante.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom de l'imprimante à supprimer.

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Remove-PrinterDriver

Supprime le pilote d'imprimante de l'ordinateur spécifié.

Syntaxe

Remove-PrinterDriver
      [-Name] <String[]>
      [[-PrinterEnvironment] <String[]>]
      [-ComputerName <String>]
      [-RemoveFromDriverStore]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PrinterDriver
      -InputObject <CimInstance[]>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-PrinterDriver supprime un pilote d'imprimante de l'ordinateur spécifié. Vous pouvez spécifier le pilote d'imprimante à supprimer à l'aide d'un objet d'imprimante récupéré par Get-Printer ou en spécifiant un nom d'imprimante.

Vous pouvez utiliser des caractères génériques avec Remove-PrinterDriver. Vous pouvez utiliser Remove-PrinterDriver dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Remove-PrinterDriver.

Exemples

Exemple1: Supprimer le pilote d'imprimante

Remove-PrinterDriver -Name "Microsoft XPS Document Writer v4"

Cette commande supprime le pilote Microsoft XPS Document Writer v4.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel supprimer le pilote d'imprimante.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom du pilote d'imprimante à supprimer.

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-PrinterEnvironment

Spécifie l'environnement du pilote d'imprimante.

 

-RemoveFromDriverStore

Spécifie s'il faut supprimer le pilote d'imprimante du magasin de pilotes.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Remove-PrinterPort

Supprime le port d'imprimante spécifié de l'ordinateur spécifié.

Syntaxe

Remove-PrinterPort
      [-Name] <String[]>
      [-ComputerName <String>]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PrinterPort
      -InputObject <CimInstance[]>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-PrinterPort supprime le port d'imprimante spécifié de l'ordinateur spécifié.

Vous pouvez supprimer un port d'imprimante en spécifiant le nom du port, ou vous pouvez utiliser un objet d'imprimante récupéré à l'aide de Get-PrinterPort.

Vous pouvez utiliser des caractères génériques avec Remove-PrinterPort. Vous pouvez utiliser Remove-PrinterPort dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Remove-PrinterPort.

Exemples

Exemple 1: Supprimer un port d'imprimante spécifié

Remove-PrinterPort -Name "LocalPort:"

Cette commande supprime le port d'imprimante nommé LocalPort: de l'ordinateur.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel supprimer le port de l'imprimante.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom du port d'imprimante à supprimer.

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Remove-PrintJob

Supprime un travail d'impression sur l'imprimante spécifiée.

Syntaxe

Remove-PrintJob
      [-InputObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PrintJob
      [-ComputerName <String>]
      [-ID] <UInt32>
      [-PrinterName] <String>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PrintJob
      [-ID] <UInt32>
      [-PrinterObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-PrintJob supprime une tâche d'impression sur l'imprimante spécifiée.

Vous pouvez spécifier la tâche d'impression à supprimer en spécifiant les paramètres PrinterName et ID, en spécifiant l'objet et la tâche de l'imprimante et le paramètre ID, ou en spécifiant un objet de tâche d'impression en entrée.

Vous ne pouvez pas utiliser de caractères génériques avec Remove-PrintJob. Vous pouvez utiliser Remove-PrintJob dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Remove-PrintJob.

Exemples

Exemple 1: Supprimer une tâche d'impression sélectionnée

Remove-PrintJob -PrinterName "PrinterName" -ID 1

Cette commande supprime la tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName.

Exemple 2: Supprimer une tâche d'impression à l'aide de l'objet imprimante et de l'ID de tâche d'impression

$Printer = Get-Printer -PrinterName "PrinterName"
Remove-PrintJob -PrinterObject $Printer -ID "1"

La première commande obtient l'imprimante nommée PrinterName à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande supprime la tâche d'impression qui a un ID de 1 de l'imprimante dans $Printer.

Exemple 3: Supprimer une tâche d'impression à l'aide d'un objet tâche d'impression

$printJob = Get-PrintJob - PrinterName "PrinterName" -ID 1
Remove-PrintJob -InputObject $printJob

La première commande obtient une tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName à l'aide de l'applet de commande Get-PrintJob. La commande stocke la tâche dans la variable $PrintJob.

La deuxième tâche supprime la tâche d'impression dans $PrintJob.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur sur lequel supprimer la tâche d'impression.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-ID

Spécifie l'ID d'une tâche d'impression à supprimer sur l'imprimante spécifiée.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-PrinterName

Spécifie un nom d'imprimante sur lequel supprimer la tâche d'impression.

 

-PrinterObject

Spécifie l'objet qui contient l'imprimante sur laquelle supprimer la tâche d'impression.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Rename-Printer

Renomme l'imprimante spécifiée.

Syntaxe

Rename-Printer
      [-Name] <String>
      [-NewName] <String>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-Printer
      [-NewName] <String>
      [-InputObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Rename-Printer renomme l'imprimante spécifiée sur un ordinateur. Vous pouvez spécifier l'imprimante à renommer en utilisant soit un objet d'imprimante récupéré par l'applet de commande Get-Printer, soit en spécifiant un nom d'imprimante.

Vous ne pouvez pas utiliser de caractères génériques avec Rename-Printer. Vous pouvez utiliser Rename-Printer dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Rename-Printer.

Exemples

Exemple 1: Renommer une imprimante

Rename-Printer -Name "Microsoft XPS Document Writer" -NewName "MXDW"

Cette commande renomme le nom de l'imprimante Microsoft XPS Document Writer en MXDW.

Exemple 2: Renommer une imprimante à l'aide d'un objet imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
Rename-Printer -InputObject $Printer -NewName "MXDW"

La première commande obtient une imprimante nommée Microsoft XPS Document Writer en utilisant Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande renomme l'imprimante dans $Printer en MXDW.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom de l'imprimante à renommer.

 

-NewName

Spécifie le nouveau nom de l'imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Restart-PrintJob

Redémarre une tâche d'impression sur l'imprimante spécifiée.

Syntaxe

Restart-PrintJob
       [-InputObject] <CimInstance>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restart-PrintJob
       [-ComputerName <String>]
       [-ID] <UInt32>
       [-PrinterName] <String>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restart-PrintJob
       [-ID] <UInt32>
       [-PrinterObject] <CimInstance>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

La cmdlet Restart-PrintJob redémarre une tâche d'impression sur l'imprimante spécifiée.

Vous pouvez spécifier la tâche d'impression à redémarrer en spécifiant les paramètres PrinterName et ID , en spécifiant l'objet imprimante et le paramètre ID, ou en spécifiant l'objet de tâche en tant qu'entrée.

Vous ne pouvez pas utiliser de caractères génériques avec Restart-PrintJob. Vous pouvez utiliser Restart-PrintJob dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur à utiliser Restart-PrintJob.

Exemples

Exemple 1: Redémarrez une tâche d'impression sélectionnée

Restart-PrintJob -PrinterName "PrinterName" -ID 1

Cette commande redémarre la tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName.

Exemple 2: Redémarrez une tâche d'impression en utilisant l'objet imprimante et l'ID de la tâche d'impression

$Printer = Get-Printer -PrinterName "PrinterName"
Restart-PrintJob -PrinterObject $Printer -ID 1

La première commande obtient une imprimante nommée PrinterName à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande redémarre la tâche d'impression qui a l'ID 1 sur l'imprimante dans $Printer.

Exemple 3: Redémarrez la tâche d'impression à l'aide de l'objet de tâche

$PrintJob = Get-PrintJob -PrinterName "PrinterName" -ID 1
Restart-PrintJob -InputObject $PrintJob

La première commande obtient une tâche d'imprimante qui a l'ID 1 sur une imprimante nommée PrinterName à l'aide de l'applet de commande Get-PrintJob. La commande stocke le résultat dans la variable $PrintJob.

La deuxième commande redémarre la tâche d'impression dans $PrintJob.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur sur lequel redémarrer la tâche d'impression.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-ID

Spécifie l'ID de la tâche d'impression à redémarrer sur l'imprimante spécifiée. Vous pouvez utiliser des caractères génériques.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-PrinterName

Spécifie le nom de l'imprimante sur lequel redémarrer la tâche d'impression.

 

-PrinterObject

Spécifie l'objet imprimante qui contient l'imprimante sur laquelle redémarrer la tâche d'impression.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Resume-PrintJob

Reprend un travail d'impression suspendu.

Syntaxe

Resume-PrintJob
      [-InputObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Resume-PrintJob
      [-ComputerName <String>]
      [-ID] <UInt32>
      [-PrinterName] <String>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Resume-PrintJob
      [-ID] <UInt32>
      [-PrinterObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Resume-PrintJob reprend un travail d'impression suspendu sur l'imprimante spécifiée. La cmdlet Resume-PrintJob n'a aucun effet si un travail d'impression est en cours d'exécution.

Vous pouvez spécifier la tâche d'impression à reprendre en spécifiant les paramètres PrinterName et ID , en spécifiant l'objet imprimante et le paramètre ID, ou en spécifiant l'objet de tâche d'impression comme entrée.

Vous ne pouvez pas utiliser de caractères génériques avec Resume-PrintJob.

Exemples

Exemple 1: Reprendre un travail d'impression suspendu

Resume-PrintJob - PrinterName "PrinterName" -ID 1

Cette commande reprend le travail d'impression avec un ID de 1, qui a été suspendu sur l'imprimante nommée PrinterName.

Exemple 2: Reprendre une tâche d'impression à l'aide d'un objet d'imprimante et d'un ID de tâche

$Printer = Get-Printer -PrinterName "PrinterName"
Resume-PrintJob -PrinterObject $Printer -ID 1

La première commande obtient une imprimante nommée PrinterName à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande reprend le travail d'impression qui a l'ID 1 sur l'imprimante dans $Printer.

Exemple 3: Reprendre une tâche d'impression en utilisant un objet de tâche

$PrintJob = Get-PrintJob - PrinterName "PrinterName" -ID 1
Resume-PrintJob -InputObject $PrintJob

La première commande obtient une tâche d'imprimante qui a l'ID 1 sur une imprimante nommée PrinterName à l'aide de l'applet de commande Get-PrintJob. La commande stocke le résultat dans la variable $PrintJob.

La deuxième commande reprend le travail d'impression dans $PrintJob.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-ComputerName

Spécifie le nom de l'ordinateur sur lequel reprendre le travail d'impression.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-ID

Spécifie l'ID de la tâche d'impression à reprendre sur l'imprimante spécifiée. Vous pouvez utiliser des caractères génériques.

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

-PrinterName

Spécifie le nom de l'imprimante sur laquelle reprendre le travail d'impression.


-PrinterObject

Spécifie l'objet qui contient l'imprimante sur laquelle reprendre le travail d'impression.

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Set-PrintConfiguration

Définit les informations de configuration de l'imprimante spécifiée.

Syntaxe

Set-PrintConfiguration
   [-Collate <Boolean>]
   [-Color <Boolean>]
   [-DuplexingMode <DuplexingModeEnum>]
   [-PaperSize <PaperSizeEnum>]
   [-PrintTicketXml <String>]
   [-PrinterObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrintConfiguration
   [-Collate <Boolean>]
   [-Color <Boolean>]
   [-DuplexingMode <DuplexingModeEnum>]
   [-PaperSize <PaperSizeEnum>]
   [-PrintTicketXml <String>]
   [-ComputerName <String>]
   [-PrinterName] <String>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrintConfiguration
   [-InputObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-PrintConfiguration définit la configuration de l'imprimante pour l'imprimante spécifiée. En utilisant la cmdlet Set-PrintConfiguration, vous pouvez gérer la configuration des fonctionnalités suivantes:

La cmdlet Set-PrintConfiguration accepte également les objets de configuration d'impression à l'aide de l'applet de commande Get-PrintConfiguration.

Vous ne pouvez pas utiliser de caractères génériques avec Set-PrintConfiguration. Vous pouvez utiliser Set-PrintConfiguration dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur à utiliser Set-PrintConfiguration.

Exemples

Exemple 1: Définissez le format de papier par défaut

Set-PrintConfiguration -PrinterName "Microsoft XPS Document Writer" -PaperSize A4

Cette commande définit la taille de papier par défaut de l'imprimante nommée Microsoft XPS Document Writer printer à A4.

Exemple 2: Définissez le format de papier par défaut en utilisant l'objet de configuration d'impression

$PrintConfiguration = Get-PrintConfiguration -PrinterName "Microsoft XPS Document Writer"
$PrintConfiguration.paperSize = A4
Set-PrintConfiguration -InputObject $PrintConfiguration

La première commande obtient une configuration d'imprimante en utilisant Get-PrintConfiguration. La commande stocke le résultat dans la variable $PrintConfiguration.

La deuxième commande affecte la valeur A4 à la propriété paperSize de $PrintConfiguration.

La commande finale définit la valeur de la configuration de l'imprimante à la valeur modifiée de $PrintConfiguration.

Exemple 3: Définissez la taille de papier par défaut de toutes les imprimantes

$Printers = Get-Printer * Foreach ($Printer in $Printers){
  Set-PrintConfiguration -PrinterName $Printer.name -PaperSize A4
  }

Cette commande obtient toutes les imprimantes dans une variable $Printers, puis boucle à travers toutes les imprimantes et affiche les propriétés.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-Collate

Spécifie s'il faut rassembler la sortie de l'imprimante par défaut.

 

-Color

Spécifie si l'imprimante doit utiliser l'impression couleur ou en niveaux de gris par défaut.

 

-ComputerName

Spécifie le nom de l'ordinateur sur lequel se trouve l'imprimante.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-DuplexingMode

Spécifie le mode duplexage utilisé par défaut par l'imprimante.

Valeurs accéptées : OneSided, TwoSidedLongEdge, TwoSidedShortEdge

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-PaperSize

Spécifie le format de papier utilisé par défaut par l'imprimante.

Valeurs acceptées : Enveloppe1, Enveloppe1, Enveloppe1, Enveloppe1, Enveloppe1, Externe, Externe, Externe, Externe, Externe, Externe, Externe, Externe, Externe, Externe, Externe, A3, Enveloppe10, Enveloppe14, Enveloppe JaponaisDoublePostcard, A6, JaponaisEnveloppeKaku2, JaponaisEnveloppeKaku3,JaponaisEnveloppéChou3, JaponaisEnveloppéChou4, LetterRotaté, A3Roté, A4Roté, A5Roté, JaponaisEnveloppéKaku2Roté, JaponaisPostcardRotéLetterRotated, A3Rotated, A4Rotated, A5Rotated, B4JISRotated, B5JISRotated, JapanesePostcardRotated PRC2Rotated, A6Rotated, JapaneseEnvelopeKaku2Rotated, JapaneseEnvelopeKaku3Rotated, JaponaisLetterRotated, A3Rotated, A4Rotated, A5Rotated, B4JISRotated, B5JISRotated, JapanesePostcardRotated PRC2Rotated, A6Rotated, JapaneseEnvelopeKaku2Rotated, JapaneseEnvelopeKaku3Rotated, JaponaisJaponaisPostcardRoté, JaponaisDoublePostcardRoté, A6Roté, JaponaisEnveloppéKaku2Roté, JaponaisEnveloppéKaku3Roté, JaponaisEnveloppéChou3Rouvert, JaponaisEnveloppéVous4, JaponaisJaponaisPostcardRoté, JaponaisDoublePostcardRoté, A6Roté, JaponaisEnveloppéKaku2Roté, JaponaisEnveloppéKaku3Roté, JaponaisEnveloppéChou3Rouvert, JaponaisEnveloppéVous4, JaponaisJaponaisEnveloppeChou4Rotated, B6JIS, B6JISRotated, Sheet12x11, JaponaisEnveloppeYou4, JaponaisEnveloppeYou4Rotated, PRC32K, PRC32K, PRCEnvelope1, PRCEnvelope2, PRCEnvelope3, PRCEnvelope4, PRCEnvelope4JaponaisEnveloppeChou4Rotated, B6JIS, B6JISRotated, Sheet12x11, JaponaisEnveloppeYou4, JaponaisEnveloppeYou4Rotated, PRC32K, PRC32K, PRCEnvelope1, PRCEnvelope2, PRCEnvelope3, PRCEnvelope4, PRCEnvelope4PRCEnvelope1Rotated, PRCEnvelope2Rotated, PRCEnvelope3Rotated, PRCEnvelope4Rotated, PRCEnvelope5Rotated, PRCEnvelope6Rotated, PRCEnvelope7Rotated, PRCEnvelope8Rotated, PRCEnvelope9Rotated, PRCEnvelope10RotatedPRCEnvelope1Rotated, PRCEnvelope2Rotated, PRCEnvelope3Rotated, PRCEnvelope4Rotated, PRCEnvelope5Rotated, PRCEnvelope6Rotated, PRCEnvelope7Rotated, PRCEnvelope8Rotated, PRCEnvelope9Rotated, PRCEnvelope10Rotated

-PrinterName

Spécifie l'imprimante sur laquelle définir les informations de configuration.

 

-PrinterObject

Spécifie l'objet qui contient l'imprimante sur laquelle modifier les paramètres de configuration.

 

-PrintTicketXml

Spécifie le ticket d'impression XML définissant les paramètres d'impression par défaut pour cette imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Set-Printer

Mise à jour de la configuration d'une imprimante existante.

Syntaxe

Set-Printer
   [-Name] <String[]>
   [-ComputerName <String>]
   [-Comment <String>]
   [-Datatype <String>]
   [-DriverName <String>]
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs <Boolean>]
   [-Location <String>]
   [-PermissionSDDL <String>]
   [-PortName <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published <Boolean>]
   [-RenderingMode <RenderingModeEnum>]
   [-SeparatorPageFile <String>]
   [-Shared <Boolean>]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-DisableBranchOfficeLogging <Boolean>]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-Printer
   -InputObject <CimInstance[]>
   [-Comment <String>]
   [-Datatype <String>]
   [-DriverName <String>]
   [-UntilTime <UInt32>]
   [-KeepPrintedJobs <Boolean>]
   [-Location <String>]
   [-PermissionSDDL <String>]
   [-PortName <String>]
   [-PrintProcessor <String>]
   [-Priority <UInt32>]
   [-Published <Boolean>]
   [-RenderingMode <RenderingModeEnum>]
   [-SeparatorPageFile <String>]
   [-Shared <Boolean>]
   [-ShareName <String>]
   [-StartTime <UInt32>]
   [-DisableBranchOfficeLogging <Boolean>]
   [-BranchOfficeOfflineLogSizeMB <UInt32>]
   [-WorkflowPolicy <WorkflowPolicyEnum>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-Printer met à jour la configuration de l'imprimante spécifiée.

Utilisez le paramètre KeepPrintedJobs pour conserver les travaux imprimés.

Vous pouvez spécifier l'imprimante à mettre à jour à l'aide d'un objet d'imprimante récupéré par l'applet de commande Get-Printer ou en spécifiant un nom d'imprimante.

Vous pouvez utiliser des caractères génériques avec Set-Printer. Vous pouvez utiliser Set-Printer dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Set-Printer.

Exemples

Exemple 1: Réglez l'imprimante en conservant les travaux imprimés

Set-Printer -Name "Microsoft XPS Document Writer" -KeepPrintedJobs $True

Cette commande configure l'imprimante Microsoft XPS Document Writer pour conserver les travaux imprimés.

Exemple 2: Configurez l'imprimante en conservant les travaux imprimés à l'aide d'un objet d'imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
$Printer.KeepPrintedJobs = $True
Set-Printer -InputObject $Printer

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande attribue une valeur de $True au paramètre KeepPrintedJobs de l'objet imprimante $Printer.

La commande finale définit la valeur de la valeur révisée de $Printer.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-BranchOfficeOfflineLogSizeMB

Spécifie la taille maximale, en mégaoctets, du fichier journal hors ligne distant de la succursale pour cette imprimante. Vous ne pouvez pas spécifier ce paramètre pour les files d'attente non partagées ou les files d'attente qui n'ont pas activé la succursale.

 

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-Comment

Spécifie le texte à ajouter au champ Commentaire pour l'imprimante spécifiée.

 

-ComputerName

Spécifie le nom de l'ordinateur sur lequel l'imprimante est installée.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-Datatype

Spécifie le type de données utilisé par l'imprimante pour enregistrer les travaux d'impression.

 

-DisableBranchOfficeLogging

Indique si la journalisation à distance des succursales est désactivée. Vous ne pouvez pas spécifier ce paramètre pour les files non partagées.

 

-DriverName

Spécifie le nom du pilote d'imprimante pour l'imprimante.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-KeepPrintedJobs

Spécifie si les travaux d'imprimante dans la file d'attente sont conservés.

 

-Location

Spécifie l'emplacement de l'imprimante.

 

-Name

Spécifie le nom de l'imprimante à modifier.

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-PermissionSDDL

Spécifie les autorisations pour l'imprimante en tant que chaîne SDDL.

 

-PortName

Spécifie le nom du port utilisé ou créé pour l'imprimante.

 

-PrintProcessor

Spécifie le nom du processeur d'impression utilisé par l'imprimante.

 

-Priority

Spécifie la priorité relative de la file d'attente.

 

-Published

Spécifie si l'imprimante est publiée dans le service d'annuaire réseau.

 

-RenderingMode

Spécifie le mode de rendu de l'imprimante.

Valeurs acceptées : SSR, RSE, BranchOffice

 

-SeparatorPageFile

Spécifie le chemin et le nom de la page de séparation à utiliser par l'imprimante.

 

-Shared

Spécifie si l'imprimante est partagée.

 

-ShareName

Spécifie le nom par lequel partager l'imprimante sur le réseau. Pour modifier l'état de partage d'une imprimante, spécifiez Partagé paramètre.

 

-StartTime

Spécifie l'heure de démarrage de la disponibilité de l'imprimante.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-UntilTime

Spécifie l'heure de fin de la disponibilité de l'imprimante.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

 

-WorkflowPolicy

Permet à un administrateur d'associer une imprimante donnée à une application Workflow spécifique. Ce paramètre ne permet pas à l'administrateur de remplacer l'association périphérique-application créée à l'aide du service de métadonnées de périphérique.

 

PrintManagement

Set-PrinterProperty

Modifie les propriétés de l'imprimante pour l'imprimante spécifiée.

Syntaxe

Set-PrinterProperty
   [-PrinterName] <String>
   [-PropertyName] <String>
   [-Value] <String>
   [-ComputerName <String>]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrinterProperty
   [-PropertyName] <String>
   [-Value] <String>
   [-PrinterObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PrinterProperty
   [-InputObject] <CimInstance>
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

La cmdlet Set-PrinterProperty modifie les propriétés de l'imprimante pour l'imprimante spécifiée.

Vous ne pouvez pas utiliser de caractères génériques avec Set-PrinterProperty. Vous pouvez utiliser Set-PrinterProperty dans une session à distance Windows PowerShell.

Vous avez besoin des informations d'identification d'administrateur pour exécuter Set-PrinterProperty.

Exemples

Exemple 1: Définir une propriété d'imprimante

Set-PrinterProperty -PrinterName "Printer02" -PropertyName "Config:PropertyName" -Value True

Cette commande définit la propriété Config:PropertyName de l'imprimante nommée Printer02 à True.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-ComputerName

Spécifie le nom de l'ordinateur pour lequel modifier les propriétés de l'imprimante.

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-PrinterName

Spécifie le nom de l'imprimante pour laquelle modifier les propriétés.

 

-PrinterObject

Spécifie l'objet imprimante pour lequel mettre à jour les propriétés de l'imprimante.

 

-PropertyName

Spécifie le nom de la propriété à mettre à jour.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-Value

Spécifie la nouvelle valeur de la propriété printer.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

PrintManagement

Suspend-PrintJob

Suspend un travail d'impression sur l'imprimante spécifiée.

Syntaxe

Suspend-PrintJob
       [-InputObject] <CimInstance>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Suspend-PrintJob
       [-ComputerName <String>]
       [-ID] <UInt32>
       [-PrinterName] <String>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Suspend-PrintJob
       [-ID] <UInt32>
       [-PrinterObject] <CimInstance>
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

La cmdlet Suspend-PrintJob suspend un travail d'impression sur l'imprimante spécifiée. Utilisez l'applet de commande Resume-PrintJob pour reprendre le travail d'impression suspendu.

Vous pouvez spécifier la tâche d'impression à suspendre en spécifiant les paramètres PrinterName et ID, en spécifiant un objet d'imprimante et le paramètre ID, ou en spécifiant un objet de tâche d'impression en entrée.

Vous ne pouvez pas utiliser de caractères génériques avec Suspend-PrintJob. Vous pouvez utiliser Suspend-PrintJob dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Suspend-PrintJob.

Exemples

Exemple 1: Suspendre un travail d'impression spécifique

Suspend-PrintJob -PrinterName "PrinterName" -ID 1

Cette commande suspend la tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName.

Exemple 2: Suspendre une tâche d'impression à l'aide d'un objet d'imprimante et d'un ID de tâche d'impression

$Printer = Get-Printer -Name "PrinterName"
Suspend-PrintJob -PrinterObject $Printer -ID 1

La première commande obtient une imprimante nommée PrinterName à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande suspend la tâche d'impression qui a un ID de 1 sur l'imprimante stockée dans $Printer.

Exemple 3: Suspendre une tâche d'impression à l'aide d'un objet de tâche d'impression

$PrintJob = Get-PrintJob -PrinterName "PrinterName" -ID 1
Suspend-PrintJob -InputObject $printJob

La première commande obtient une tâche d'impression qui a l'ID 1 sur l'imprimante nommée PrinterName à l'aide de Get-PrintJob. La commande stocke le résultat dans la variable $PrintJob.

La deuxième commande suspend le travail d'impression dans $PrintJob.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

-ComputerName

Spécifie le nom de l'ordinateur sur lequel suspendre le travail d'impression.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

-ID

Spécifie l'ID de la tâche d'impression à suspendre sur l'imprimante spécifiée. Vous pouvez utiliser des caractères génériques.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

-PrinterName

Spécifie le nom de l'imprimante sur laquelle suspendre le travail d'impression.


-PrinterObject

Spécifie l'objet qui contient l'imprimante sur laquelle suspendre le travail d'impression.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.

Tutoriels

Tutoriels

Tester une connexion en PowerShell avec Test-NetConnection

Dans ce tutoriel, je vais vous parler de la Cmdlet PowerShell Test-NetConnection qui va vous permettre de lancer des diagnostics réseaux.

Cette commande peut remplacer les utilitaires suivants :

Avec une seule Cmdlet PowerShell vous allez pouvoir tout faire !

Dans ce tutoriel voici ce que l’on va voit :

Avant de commencer, la Cmdlet Test-NetConnection prend un premier paramètre -ComputerName qui n’est pas obligé d’être nommer.

Faire un ping en PowerShell avec Test-NetConnection

On va commencer avec une utilisation simple, qui va être de faire un ping.

Test-NetConnection google.fr

image.png

Comme on peut le voir sur la capture, la commande nous retourne ces informations :

Maintenant, l’intérêt de PowerShell c’est que l’on va pouvoir faire des scripts, pour illustrer cela via un script simple qui nous permet de tester un ping.

<#
	Script for TEST Connection
#>

param(
	$RemoteHost = "google.fr"
)

$ResultTest = Test-NetConnection -ComputerName $RemoteHost


if( $ResultTest.PingSucceeded ){
	Write-Output "Test OK for $RemoteHost"
}else{

	Write-Output "/!\ Test KO for $RemoteHost"
}

Pour récupérer le résultat de la commande, il faut tester PingSucceeded.

Voici le script le résultat du script avec un hôte qui répond et qui ne répond pas.

image.png

Si vous souhaitez faire plusieurs ping ou un ping en continu, il faut utiliser la Cmdlet Test-Connection.

Pour effectuer 100 ping

Test-Connection google.fr -Count 100

Pour un ping en continu :

Test-Connection google.fr -Count ([int32]::MaxValue)

Tester un port en PowerShell avec Test-NetConnection

Maintenant, on va voir comment tester un port en PowerShell comme on le ferait avec telnet.

L’avantage d’utiliser Test-NetConnection par rapport à telnet, c’est qu’il n’y a pas besoin d’installer le client Telnet.

Pour tester un port, il faut ajouter le paramètre -Port et le numéro de celui.

Ce qui nous donne :

Test-NetConnection rdr-it.com -Port 443

image.png

Ici, j’ai testé le port 443 (HTTPS) du serveur du site Internet, pour avoir le résultat du test, il faut regarder la valeur de TcpTestSucceeded.

En cas d’échec, la Cmdlet avec tester l’hôte à l’aide d’un ping.

image.png

On peut aussi exploiter ce retour dans un script PowerShell, à la différence du ping, il faut analyser le résultat de TcpTestSucceeded.

Tester la route avec Test-NetConnection

Pour finir ce tutoriel, nous allons voir comment tester le routage avec Test-NetConnection en PowerShell.

Si vous avez plusieurs routes différentes de configurer, le premier paramètre que l’on peut utiliser est -DiagnoseRouting, qui va analysé quel route (passerelle) va être utiliser pour accéder au serveur distant.

image.png

Le second paramètre que l’on va voir est –traceroute qui permet d’avoir l’équivalent d’un tracert et de voir tous les routeurs qui sont utilisés.

image.png

Tutoriels

Créer un fichier texte et écrire dedans

Dans ce « petit » tutoriel, je vais vous expliquer comment créer un fichier texte en Powershell et ensuite comment écrire du contenu dedans.

Dans ce tutoriel, nous allons voir 4 Cmdlet Powershell :

 

Nous allons commencer par créer le fichier.

New-Item TextFile.txt

image.png

Ici le fichier est créé dans le dossier courant, il est possible de mettre un chemin absolu.

La création d’un fichier est très simple et se fait simplement avec la Cmdlet New-Item en indiquant le chemin / nom du fichier.

Maintenant, on va voir comment ajouter du contenu avec les Cmdlet Set-Content et Add-Content. La principale différence entre les deux commandes, c’est que Set-Content va d’abord effacer le fichier puis ajouter le contenu, alors que la commande Add-Content va ajouter le contenu à la fin fichier.

Pour ajouter du contenu dans un fichier vide ou remplacer le contenu :

Set-Content TextFile.txt "Content to add in the text file"

image.png

La commande n’a pas de retour particulier.

Pour ajouter du contenu à la fin du fichier :

Add-Content TextFile.txt "Content to add in the text file"

image.png

En utilisant la cmdlet Get-Content, on peut voir le contenu du fichier :

Get-Content TextFile.txt

image.png

Tutoriels

Importer et exporter des drivers

powershell.png

Il est possible d'exporter les drivers d'un poste pour les sauvegarder et les exporter vers un autre poste.

Export

Après avoir ouvert un terminal PowerShell en tant qu'administrateur, exécutez la commande suivante :

Export-WindowsDriver -Online -Destination D:\DriversBackup

Le répertoire de destination doit exister et être accessible en écriture.

Import

Après avoir ouvert un terminal PowerShell en tant qu'administrateur, exécutez la commande suivante :

Get-ChildItem "D:\DriversBackup\" -Recurse -Filter "*.inf" | ForEach-Object { PNPUtil.exe /add-driver $_.FullName /install }

Le répertoire source doit contenir l'ensemble des drivers que l'on souhaite importer.

Tutoriels

Afficher le contenu d’un fichier texte

Dans ce tutoriel, je vais vous montrer comment afficher le contenu d’un fichier texte (txt, yaml, php, vbs …) dans une fenêtre PowerShell.

En faite, c’est très simple, il suffit d’utiliser la Cmdlet Get-Content et d’indiquer le nom du fichier.

Ce qui donne :

Get-Content MyFile.txt

image.png

Si vous êtes habitué à la commande cat sous Linux, vous pouvez aussi l’utiliser

cat MyFile.txt

La commande cat est ici un alias de la commande Get-Content, on peut le voir avec la Cmdlet Get-Alias.

image.png

Il est aussi possible de passer des paramètres supplémentaires à la commande pour afficher seulement les x premières ou dernières lignes.

Pour rentre plus lisible, j’ai ajouté des numéros à mon fichier, voici son contenu :

image.png

Comme on peut le voir, le fichier contient 8 lignes.

Pour afficher les x premières lignes, on va ajouter le parametres -TotalCount X.

Pour afficher les 3 premières d’un fichier, on va utiliser la commande :

Get-Content MyFile.txt -TotalCount 3

image.png

Si vous souhaitez afficher les dernières lignes d’un fichier, il faut utiliser le paramètre -Tail X.

Ce qui nous donne pour les 4 dernières ligne du fichier :

Get-Content MyFile.txt -Tail 4

image.png

 

Tutoriels

PowerShell : gérer les applications sur Windows avec WinGet

WinGet est le gestionnaire de paquets pour Windows. Il permet d'installer, de mettre à jour et de gérer des applications via la ligne de commande. Pour simplifier encore plus ces tâches, Microsoft propose le module PowerShell "Microsoft.WinGet.Client". Ce module offre des commandes natives PowerShell, rendant l'utilisation de WinGet plus intuitive et puissante, qu'à partir du jeu de commandes de l'outil en lui-même.

Dans ce tutoriel, nous allons voir comment installer le module Microsoft.WinGet.Client et l'utiliser pour gérer vos applications sur Windows, mais également découvrir certains de ses avantages.

Note : je vous recommande d'utiliser PowerShell 7 ou supérieur afin de vous assurer de la compatibilité des commandes qui composent ce tutoriel.

Installation du module Microsoft.WinGet.Client

Ouvrez une console PowerShell sur votre machine et installez le module via la commande suivante :

Install-PSResource Microsoft.WinGet.Client

Vous pouvez également utiliser l'ancienne commande : Install-Module.

Ensuite, importez le module :

Import-Module Microsoft.WinGet.Client

Vous pouvez aussi lister les commandes du module :

Get-Command -Module Microsoft.WinGet.Client

Vous obtiendrez ceci au final :

Quand c'est fait, vous êtes prêt pour la suite !

Utilisation du module WinGet

Une fois le module installé et importé, vous pouvez commencer à utiliser les commandes natives PowerShell pour gérer vos applications.

Rechercher un paquet

(exemple : 7-Zip)

Find-WinGetPackage "7-Zip"

f

Vous pouvez déjà noter que contrairement à la commande native qui serait "winget search "7-Zip"", le résultat obtenu est un objet tableau et non du texte ! Ce qui signifie que vous pouvez stocker le résultat dans une variable PowerShell et le manipuler, ce qui offre beaucoup de possibilités.

Installer un paquet

Pour installer le paquet 7-Zip dans sa dernière version stable, exécutez cette commande :

Install-WinGetPackage -Id "7zip.7zip"

À noter qu'il est également possible de profiter de la commande précédemment utilisée et d'utiliser la pipeline :

Find-WinGetPackage -Id "7zip.7zip" | Install-WinGetPackage

Chose à savoir, la commande "Install-WinGetPackage" regorge de fonctionnalités grâce à ses paramètres, il est, par exemple, possible de tester l'installation avant même d'exécuter réellement celle-ci via le paramètre -WhatIf :

Install-WinGetPackage -Id "7zip.7zip" -WhatIf | Format-List

Ce qui donne :

Il est également possible de préciser une version (-Version), une architecture (-Architechture) x64 ou x86 par exemple, le mode (-Mode) tel qu'Interactif ou Silent… Je vous laisse découvrir la documentation grâce à la commande suivante :

 Get-Help Install-WinGetPackage -Full

Lister les paquets installés

Pour afficher la liste des paquets installés sur votre système via Winget, utilisez la commande suivante :

Get-WinGetPackage

Cette commande retourne dans la console une liste détaillée des logiciels installés, incluant leur nom, leur version, et leur ID.

Mettre à jour un paquet

Pour mettre à jour un paquet spécifique avec Winget, utilisez :

Update-WinGetPackage -Id "Id_du_paquet"

Désinstaller un paquet

Pour désinstaller un paquet spécifique, utilisez la commande suivante :

Uninstall-WinGetPackage -Id "Id_du_paquet"

Vous pouvez identifier l'ID d'un paquet en listant les paquets installés avec "Get-WinGetPackage".

Exporter la liste des paquets installés dans un fichier CSV

Pour sauvegarder la liste des paquets installés dans un fichier au format CSV, exécutez la commande ci-dessous :

Get-WinGetPackage | Export-Csv -Path "C:\exemple\paquets_list.csv"

Cet exemple va créer le fichier "C:\exemple\paquets_list.csv" en sortie.

Installation en masse de paquets à partir d'une liste

Vous pouvez aussi importer une liste de paquets à installer à partir d'un fichier CSV et procéder à l'installation en masse de toutes les applications référencées dans ce fichier CSV. Une boucle ForEach permet de traiter l'ensemble du fichier CSV :

$packages = Import-Csv -Path "C:\exemple\paquets_list.csv"
foreach ($package in $packages) {
   Install-WinGetPackage -Id $package.Id
}

Le cmdlet Repair-WinGetPackageManager

Cette commande est particulière, elle permet non seulement de réparer l'installation du client WinGet (ou de le mettre à jour), mais elle permet tout simplement aussi de l'installer ! Ce qui veut dire que vous pouvez d'abord installer le module, exécuter cette commande, puis utiliser WinGet directement.

Repair-WinGetPackageManager -Latest -Force

Conclusion

L'utilisation du module PowerShell Microsoft.WinGet.Client présente plusieurs avantages par rapport à l'utilisation classique de WinGet via la ligne de commande :

Le module simplifie grandement l'utilisation de WinGet en intégrant des commandes natives PowerShell. Que vous soyez un débutant ou un utilisateur avancé, ce module vous permettra de gérer vos applications de manière plus efficace et plus intuitive.