Erstellt ein neues Element.
Syntax
New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "New-Item" erstellt ein neues Element und legt seinen Wert fest. Die Elementtypen, die erstellt werden können, sind abhängig vom Speicherort des Elements. Im Dateisystem werden mit New-Item z. B. Dateien und Ordner erstellt. In der Registrierung erstellt New-Item Registrierungsschlüssel und -einträge.
Im Verzeichnis "Security" können Sie mit dem Cmdlet "New-Item" die Plug-In-Sicherheit erstellen und konfigurieren.
Parameter
-URI <Uri>
Bezeichnet den URI, für den der Zugriff anhand des Werts für den Sddl-Parameter autorisiert wird.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-SDDL <string>
Gibt die SDDL (Security Descriptor Definition Language) für den Zugriffssteuerungseintrag an. Damit werden die Sicherheitseinstellungen
für die Autorisierung des Zugriffs auf einen angegebenen Ressourcen-URI bezeichnet.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-ExactMatch
Gibt an, wie die im Sddl-Parameter angegebenen Sicherheitseinstellungen verwendet werden sollen. Wenn der ExactMatch-Parameter auf
"True" festgelegt ist, werden mit den Sicherheitseinstellungen in SDDL nur Zugriffsversuche autorisiert, die sich auf die exakte Angabe des URI beziehen.
Wenn ExactMatch auf "False" festgelegt ist, werden mit den Sicherheitseinstellungen in SDDL Zugriffsversuche auf URIs autorisiert, die mit
der im URI angegebenen Zeichenfolge beginnen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
System.Object Sie können einen Wert für das neue Element über die Pipeline an das Cmdlet "New-Item" übergeben. |
|
Ausgaben |
Any |
Hinweise
Das Cmdlet "New-Item" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PsProvider" ein. Weitere Informationen finden Sie unter "About_Providers".
Beispiel 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)" Mit diesem Befehl wird im Verzeichnis "Security" von Resource_5967683 (einer bestimmten Ressource) ein Sicherheitseintrag erstellt.
Siehe auch