Empêche l'ordinateur de recevoir des commandes Windows PowerShell distantes.
Syntaxe
Disable-PSRemoting [-Force] [-Confirmer] [-WhatIf] [<CommonParameters>]
Description
La fonction Disable-PSRemoting désactive toutes les configurations de session sur l'ordinateur local en ajoutant une entrée « Tout refuser » à leur descripteur de sécurité. Cela empêche l'ordinateur local de recevoir des commandes distantes.
Disable-PSRemoting n'arrête pas le service WinRM ; en outre, cette fonction n'empêche pas utilisateurs de l'ordinateur local d'établir des sessions qui se connectent aux ordinateurs distants ou d'envoyer des commandes à d'autres ordinateurs.
Pour réactiver les configurations de session, utilisez l'applet de commande Enable-PSRemoting ou Enable-PSSessionConfiguration.
Pour exécuter cette fonction sur Windows Vista, Windows Server 2008 et les versions ultérieures de Windows, vous devez ouvrir Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Paramètres
-Force
Supprime toutes les invites utilisateur. Par défaut, vous êtes invité à confirmer chaque opération.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
False |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirmer
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Aucun Vous ne pouvez pas diriger d'entrée vers cette applet de commande. |
|
Sorties |
Aucun Cette applet de commande ne retourne pas d'objets. |
Remarques
Une configuration de session est un groupe de paramètres qui définissent l'environnement d'une session. Les configurations de session se trouvent sur l'ordinateur distant et sont utilisées par les sessions locales et distantes qui se connectent à l'ordinateur.
Chaque session qui se connecte à l'ordinateur doit utiliser l'une des configurations de session inscrites sur l'ordinateur. Il s'agit notamment des sessions permanentes que vous créez à l'aide de l'applet de commande New-PSSession ou Enter-PSSession, ainsi que des sessions temporaires que Windows PowerShell crée lorsque vous utilisez le paramètre ComputerName d'une applet de commande faisant appel à la technologie de communication à distance de la Gestion des services Web (par exemple, Invoke-Command). En refusant l'accès à toutes les configurations de session, vous empêchez tous les utilisateurs d'établir des sessions qui se connectent à l'ordinateur.
Disable-PSRemoting équivaut à « Disable-PSSessionConfiguration -name * ».
Exemple 1
C:\PS>disable-psremoting Description ----------- Cette commande désactive toutes les configurations de session sur l'ordinateur.
Exemple 2
C:\PS>disable-psremoting -force Description ----------- Cette commande désactive toutes les configurations de session sur l'ordinateur sans demander de confirmation.
Exemple 3
C:\PS>disable-psremoting -force
C:\PS> new-pssession -computername localhost
[localhost] Connecting to remote server failed with the following error
message : Access is denied. For more information, see the about_Remote_Troub
leshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed
C:\PS> new-pssession -computername Server01
Id Name ComputerName State Configuration Availability
-- ---- ------------ ----- ------------- ------------
1 Session1 Server01... Opened Microsoft.PowerShell Available
C:\PS> enable-pssessionConfiguration -name * -force
C:\PS> new-pssession -computername localhost
Id Name ComputerName State Configuration Availability
-- ---- ------------ ----- ------------- ------------
1 Session1 localhost Opened Microsoft.PowerShell Available
Description
-----------
Cet exemple montre l'effet de Disable-PSRemoting.
La première commande utilise Disable-PSRemoting pour désactiver toutes les configurations de session inscrites sur l'ordinateur local.
La deuxième commande utilise New-PSSession pour créer une session à distance sur l'ordinateur local (également appelée « bouclage »). Étant donné que les configurations de session que la session requiert sont désactivées, la commande échoue.
La troisième commande utilise l'applet de commande New-PSSession pour créer une session à partir de l'ordinateur local sur l'ordinateur distant Server01. Cette commande, qui utilise les configurations de session présentes sur l'ordinateur distant, réussit.
La quatrième commande fait appel à l'applet de commande Enable-PSSessionConfiguration pour réactiver toutes les configurations de session sur l'ordinateur local. Elle utilise la valeur * (tous) pour le paramètre Name.
La cinquième commande tente à nouveau d'établir une session de bouclage à l'aide de l'applet de commande New-PSSession. Cette fois-ci, la commande réussit car les configurations de session requises sont activées.
Exemple 4
C:\PS>disable-psremoting -force C:\PS> get-psSessionConfiguration | format-table -property name, permission -auto Name Permission ---- ---------- microsoft.powershell Everyone AccessDenied, BUILTIN\Administrators AccessAllowed microsoft.powershell32 Everyone AccessDenied, BUILTIN\Administrators AccessAllowed C:\PS> enable-psremoting -force WinRM already is set up to receive requests on this machine. WinRM already is set up for remote management on this machine. C:\PS>> Get-PSSessionConfiguration | ft name, Permission -auto Name Permission ---- ---------- microsoft.powershell BUILTIN\Administrators AccessAllowed microsoft.powershell32 BUILTIN\Administrators AccessAllowed Description ----------- Cet exemple montre l'effet des fonctions Disable-PSRemoting et Enable-PSRemoting sur les configurations de session. La première commande utilise la fonction Disable-PSRemoting pour désactiver toutes les configurations de session inscrites. Le paramètre force supprime toutes les invites utilisateur. La deuxième commande fait appel à l'applet de commande Get-PSSessionConfiguration pour afficher les configurations de session inscrites sur l'ordinateur. Elle utilise un opérateur de pipeline pour envoyer les résultats à une commande Format-Table, laquelle affiche uniquement les propriétés Name et Permission des configurations dans une table. La table résultante montre que l'accès aux configurations est refusé à tous les utilisateurs. La troisième commande fait appel à l'applet de commande Enable-PSRemoting pour réactiver toutes les configurations de session sur l'ordinateur. Vous pouvez également employer une commande « Enable-PsSessionConfiguration -name * ». La commande utilise le paramètre Force pour supprimer toutes les invites utilisateur et redémarrer le service WinRM sans demander de confirmation. La quatrième commande utilise Get-PSSessionConfiguration et Format-Table pour afficher les noms et autorisations des configurations de session. Les résultats indiquent que les membres du groupe Administrateurs ont maintenant accès aux configurations de session.
Voir aussi