Invoke-CMRemoteControl
Active le contrôle à distance sur les ordinateurs.
Syntaxe
Invoke-CMRemoteControl
-InputObject <IResultObject>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-CMRemoteControl
-DeviceId <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-CMRemoteControl
-DeviceName <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-CMRemoteControl
[-PassThru]
[-SiteCode <String>]
[-SiteSystemRole <String>]
-SiteSystemServerName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Invoke-CMRemoteControl active le contrôle à distance sur les ordinateurs que vous souhaitez utiliser dans une session de contrôle à distance. Vous pouvez activer le contrôle à distance sur les ordinateurs en spécifiant l’ID ou le nom des ordinateurs, les systèmes de site ou l’état du site.
Utilisez le contrôle à distance dans Configuration Manager pour administrer, fournir une assistance ou afficher à distance n’importe quel ordinateur client dans la hiérarchie. Vous pouvez utiliser le contrôle à distance pour résoudre les problèmes de configuration matérielle et logicielle sur les ordinateurs clients et pour fournir un support technique lorsque l’accès à l’ordinateur d’un utilisateur est nécessaire. Configuration Manager prend en charge le contrôle à distance des ordinateurs de groupe de travail et des ordinateurs joints à un domaine Active Directory.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Activer le contrôle à distance sur un ordinateur
PS XYZ:\>Invoke-CMRemoteControl -DeviceName "CMCEN-DIST02"Cette commande active le contrôle à distance sur l’ordinateur nommé CMCEN-DIST02.
Paramètres
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeviceId
Spécifie un tableau d’ID d’appareil.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeviceName
Spécifie un tableau de noms d’appareils.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InputObject
Spécifie l’entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou diriger l’entrée vers cette applet de commande.
| Type: | IResultObject |
| Alias: | Device, SiteStatus |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-PassThru
Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SiteCode
Spécifie un tableau de codes de site des sites Configuration Manager qui hébergent les rôles de système de site.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SiteSystemRole
Spécifie un tableau de rôles Configuration Manager que le système de site effectue.
| Type: | String |
| Alias: | Role |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SiteSystemServerName
Spécifie un tableau de noms de domaine complets (FQDN) des serveurs qui hébergent les rôles de système de site.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object