Crée un élément.
Syntaxe
New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande New-Item crée un élément et définit sa valeur. Les types d'éléments qui peuvent être créés dépendent de l'emplacement de l'élément. Par exemple, New-Item permet de créer des fichiers et des dossiers dans le système de fichiers. Dans le Registre, New-Item crée des clés de Registre et des entrées.
Dans le répertoire Security, vous pouvez utiliser l'applet de commande New-Item pour créer et configurer la sécurité de Plugin.
Paramètres
-URI <Uri>
Identifie l'URI pour lequel l'accès est autorisé en fonction de la valeur du paramètre Sddl.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-SDDL <string>
Spécifie le langage SDDL (Security Descriptor Definition Language) pour l'entrée de contrôle d'accès. Cela identifie les paramètres
de sécurité utilisés pour autoriser l'accès à un URI de ressource spécifié.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-ExactMatch
Spécifie comment utiliser les paramètres de sécurité qui sont spécifiés dans le paramètre Sddl. Si le paramètre ExactMatch a la valeur
True, les paramètres de sécurité dans Sddl sont utilisés uniquement pour autoriser les tentatives d'accès à l'URI exactement comme spécifié par l'URI.
Si ExactMatch a la valeur False, les paramètres de sécurité dans Sddl sont utilisés pour autoriser les tentatives d'accès aux URI qui commencent
par la chaîne spécifiée dans l'URI.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
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 |
System.Object Vous pouvez diriger une valeur vers l'applet de commande New-Item pour le nouvel élément. |
|
Sorties |
Any |
Remarques
L'applet de commande New-Item est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PsProvider ». Pour plus d'informations, consultez About_Providers.
Exemple 1
C:\PS>New-Item -path WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683\Security -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)" Cette commande crée une entrée de sécurité dans le répertoire Security de Resource_5967683 (ressource spécifique).
Voir aussi