Partager via


New-Item

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

Concepts

about_Providers
Get-Item
Set-Item
Remove-Item
Clear-Item
Invoke-Item
Rename-Item
Move-Item
Copy-Item