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




Inhaltsverzeichnis