PowerShell
- Management
- PrintManagement
- Add-Printer
- Add-PrinterDriver
- Add-PrinterPort
- Get-PrintConfiguration
- Get-Printer
- Get-PrinterDriver
- Get-PrinterPort
- Get-PrinterProperty
- Get-PrintJob
- Remove-Printer
- Remove-PrinterDriver
- Remove-PrinterPort
- Remove-PrintJob
- Rename-Printer
- Restart-PrintJob
- Resume-PrintJob
- Set-PrintConfiguration
- Set-Printer
- Set-PrinterProperty
- Suspend-PrintJob
- Tutoriels
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.
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:
-
-
-
AccountCreate
: Crée un compte de domaine. La cmdletAdd-Computer
crée automatiquement un compte de domaine lorsqu'il ajoute un ordinateur à un domaine. Cette option est incluse pour être complète. -
Win9XUpgrade
: Indique que l'opération de jointure fait partie d'une mise à niveau du système d'exploitation Windows. -
UnsecuredJoin
: Effectue une jointure non sécurisée. Pour demander une jointure non sécurisée, utilisez le paramètreUnsecure
ou cette option. Si vous souhaitez passer un mot de passe machine, vous devez utiliser cette option dans combinaison avec l'optionPasswordPass
. -
PasswordPass
: Définit le mot de passe de la machine à la valeur du paramètreCredential
(DomaineCrédentiel) après avoir effectué une jointure non sécurisée. Cette option indique également que la valeur deCredential
(DomainCredential) est un mot de passe machine, pas un mot de passe utilisateur. Cette option est valable uniquement lorsque l'optionUnsecuredJoin
est spécifiée. Lorsque vous utilisez cette option, les informations d'identification fourni au paramètre-Credential
doit avoir un nom d'utilisateur nul. -
JoinWithNewName
: Renomme le nom de l'ordinateur dans le nouveau domaine au nom spécifié par le paramètreNewName.
Lorsque vous utilisez le paramètreNewName
, cette option est définie automatiquement. Ceci l'option est conçue pour être utilisée avec l'applet de commandeRename-Computer
. Si vous utilisez l'appletRename-Computer
pour renommer l'ordinateur, mais ne redémarrez pas l'ordinateur pour rendre la modification effective, vous pouvez utiliser ce paramètre pour joindre l'ordinateur à un domaine avec son nouveau nom. -
JoinReadOnly
: Utilise un compte de machine existant pour joindre l'ordinateur à un contrôleur de domaine en lecture seule. Le compte machine doit être ajouté à la liste autorisée pour la stratégie de réplication de mot de passe et le mot de passe du compte doit être répliqué sur le contrôleur de domaine en lecture seule avant l'opération de jointure. -
InstallInvoke : Définit les drapeaux
create
(0x2) etdelete
(0x4) du paramètreFJoinOptions
de la méthodeJoinDomainOrWorkgroup
.
-
-
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
".
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:
-
-
- Basique
- CredSSP
- Défaut
- Digérer
- Kerberos
- Négocier
-
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.
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:
-
-
- SSR, Service Side Rendering
- CSR. Client Side Rendering
- BranchOffice. Branch Office
-
-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.
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.
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.
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:
- Collate
- Color
- Duplexing Mode
- N-Up
- Paper Size
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
- Collate
- Color
- Duplexing Mode
- N-Up
- Paper Size
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.
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.
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.
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
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 :
- Ping
- Telnet
- Traceroute (tracert)
Avec une seule Cmdlet PowerShell vous allez pouvoir tout faire !
Dans ce tutoriel voici ce que l’on va voit :
- Comment faire un ping en PowerShell
- Comment faire un « telnet' » en PowerShell pour tester un port (TCP)
- Comment faire un trace route en PowerShell
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
Comme on peut le voir sur la capture, la commande nous retourne ces informations :
- Adresse ip distante résolu quand on test un nom de domaine
- L’interface et l’adresse IP source
- Le résultat du ping
- Le temps de latence
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.
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
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.
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.
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.
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 :
- New-item : qui va être utilisé pour créer le fichier text.
- Set-Content : qui permet d’écrire dans le fichier.
- Add-Content : permet d’ajouter du contenu
- Get-Content : qui affiche le contenu du fichier
Nous allons commencer par créer le fichier.
New-Item TextFile.txt
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"
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"
En utilisant la cmdlet Get-Content, on peut voir le contenu du fichier :
Get-Content TextFile.txt
Importer et exporter des drivers
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.
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
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.
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 :
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
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
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 :
- Intégration avec PowerShell : les commandes retournent des objets PowerShell, ce qui permet de les manipuler facilement avec d'autres commandes
PowerShell. - Simplification des scripts : les commandes PowerShell sont souvent plus concises et plus faciles à lire que les commandes en 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.