Disable-PSSessionConfiguration

NOM
    Disable-PSSessionConfiguration

RÉSUMÉ
    Refuse l'accès aux configurations de session sur l'ordinateur local.

SYNTAXE
    Disable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]


DESCRIPTION
    L'applet de commande Disable-PSSessionConfiguration empêche tous les utilisateurs de l'ordinateur d'employer la configuration de session dans une session. Il s'agit d'une applet de commande avancée, conçue pour être employée par les administrateurs système pour la gestion des configurations de session personnalisées des utilisateurs.

    L'applet de commande Disable-PSSessionConfiguration ajoute un paramètre « Tout refuser » au descripteur de sécurité d'une ou de plusieurs configurations de session inscrites. Par conséquent, vous pouvez annuler l'inscription des configurations, les afficher et les modifier, mais vous ne pouvez pas les utiliser dans une session.

    Sans paramètres, Disable-PSSessionConfiguration désactive la configuration Microsoft.PowerShell, qui est la configuration par défaut utilisée pour les sessions. À moins que l'utilisateur ne spécifie une autre configuration, les utilisateurs locaux et distants ne peuvent pas créer de sessions se connectant à l'ordinateur.

    Pour désactiver toutes les configurations de session sur l'ordinateur, utilisez Disable-PSRemoting.


PARAMÈTRES
    -Force [<SwitchParameter>]
        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

    -Name <string[]>
        Spécifie les noms des configurations de session à désactiver. Entrez un ou plusieurs noms de configuration. Les caractères génériques sont autorisés. Vous pouvez également diriger une chaîne contenant un nom de configuration ou un objet de configuration de session vers Disable-PSSessionConfiguration.

        Si vous omettez ce paramètre, Disable-PSSessionConfiguration désactive la configuration de session Microsoft.PowerShell.

        Obligatoire ?                false
        Position ?                   1
        Valeur par défaut                     Microsoft.PowerShell
        Accepter l'entrée de pipeline ?       true (ByValue, ByPropertyName)
        Accepter les caractères génériques ?  true

    -Confirm [<SwitchParameter>]
        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 [<SwitchParameter>]
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

ENTRÉES
    Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String Vous pouvez diriger un objet de configuration de session ou une chaîne contenant le nom d'une configuration de session vers Disable-PSSessionConfiguration.


SORTIES
    Aucun
        Cette applet de commande ne retourne pas d'objets.


NOTES


        Pour exécuter cette applet de commande sur Windows Vista, Windows Server 2008 et les versions ultérieures de Windows, vous devez démarrer Windows PowerShell avec l'option Exécuter en tant qu'administrateur.


    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>Disable-PSSessionConfiguration


    Description
    -----------
    Cette commande désactive la configuration de session Microsoft.PowerShell.





    -------------------------- EXEMPLE 2 --------------------------

    C:\PS>disable-pssessionConfiguration -name *


    Description
    -----------
    Cette commande désactive toutes les configurations de session inscrites sur l'ordinateur.





    -------------------------- EXEMPLE 3 --------------------------

    C:\PS>disable-pssessionConfiguration -name Microsoft* -force


    Description
    -----------
    Cette commande désactive toutes les configurations de session dont le nom commence par « Microsoft ». Elle utilise le paramètre Force pour supprimer toutes les invites utilisateur de la commande.





    -------------------------- EXEMPLE 4 --------------------------

    C:\PS>Get-PSSessionConfiguration -name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration


    Description
    -----------
    Cette commande désactive les configurations de session MaintenanceShell et AdminShell.

    Elle utilise un opérateur de pipeline (|) pour envoyer les résultats d'une commande Get-PSSessionConfiguration à Disable-PSSessionConfiguration.





    -------------------------- EXEMPLE 5 --------------------------

    C:\PS>Get-PSSessionConfiguration | format-table -property Name, Permission -auto

    Name                   Permission
    ----                   ----------
    MaintenanceShell       BUILTIN\Administrators AccessAllowed
    microsoft.powershell   BUILTIN\Administrators AccessAllowed
    microsoft.powershell32 BUILTIN\Administrators AccessAllowed

    C:\PS> Disable-PSSessionConfiguration -name MaintenanceShell -force

    C:\PS> Get-PSSessionConfiguration | format-table -property Name, Permission -auto

    Name                   Permission
    ----                   ----------
    MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
    microsoft.powershell   BUILTIN\Administrators AccessAllowed
    microsoft.powershell32 BUILTIN\Administrators AccessAllowed

    C:\PS> Set-PSSessionConfiguration -name MaintenanceShell-MaximumReceivedDataSizePerCommandMB 60

    ParamName            ParamValue
    ---------            ----------
    psmaximumreceived... 60

    "Restart WinRM service"
    WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


    C:\PS> new-pssession -computername localhost -configurationName MaintenanceShell

    [localhost] Connecting to remote server failed with the following error message : Access is denied. For more information, see the about_Remote_Troubleshooting Help topic.
        + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
        + FullyQualifiedErrorId : PSSessionOpenFailed


    Description
    -----------
    Cet exemple montre l'effet de la désactivation d'une configuration de session.

    La première commande utilise les applets de commande Get-SessionConfiguration et Format-Table pour afficher uniquement les propriétés Name et Permission des objets de configuration de session. Ce format de table simplifie la lecture des valeurs des objets. Les résultats indiquent que les membres du groupe Administrateurs sont autorisés à utiliser les configurations de session.

    La deuxième commande fait appel à l'applet de commande Disable-PSSessionConfiguration pour désactiver la configuration de session MaintenanceShell. Elle utilise le paramètre Force pour supprimer toutes les invites utilisateur.

    La troisième commande répète la première. Les résultats indiquent que vous pouvez toujours obtenir l'objet représentant la configuration de session MaintenanceShell bien qu'aucun utilisateur ne soit autorisé à y accéder. L'entrée « AccessDenied » est prioritaire sur toutes les autres entrées dans le descripteur de sécurité.

    La quatrième commande fait appel à l'applet de commande Set-PSSessionConfiguration pour porter le paramètre MaximumDataSizePerCommandMB de la configuration de session MaintenanceShell à 60. Les résultats indiquent que la commande a réussi bien qu'aucun utilisateur ne soit autorisé à accéder à la configuration.

    La cinquième commande tente d'utiliser la configuration de session MaintenanceShell dans une session. Elle fait appel à l'applet de commande New-PSSession pour créer une session et au paramètre ConfigurationName pour spécifier la configuration MaintenanceShell. Les résultats indiquent que la commande New-PSSession échoue car l'utilisateur n'a pas accès à la configuration.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=144299
    about_Session_Configurations
    Enable-PSSessionConfiguration
    Get-PSSessionConfiguration
    Register-PSSessionConfiguration
    Set-PSSessionConfiguration
    Unregister-PSSessionConfiguration
    WS-Management Provider