Crea un nuovo elemento.
Sintassi
New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet New-Item crea un nuovo elemento e ne imposta il valore. I tipi di elementi che è possibile creare dipendono dal percorso dell'elemento. Ad esempio, nel file system New-Item viene utilizzato per creare file e cartelle. Nel Registro di sistema, New-Item crea chiavi e voci del Registro di sistema.
Nella directory Security, è possibile utilizzare il cmdlet New-Item per creare e configurare la sicurezza dei plug-in.
Parametri
-URI <Uri>
Identifica l'URI per il quale viene autorizzato l'accesso in base al valore del parametro Sddl.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-SDDL <string>
Specifica la stringa SDDL (Security Descriptor Definition Language) per la voce di controllo di accesso. Vengono identificate le impostazioni di sicurezza
utilizzate per autorizzare l'accesso all'URI di risorsa specificato.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-ExactMatch
Specifica come utilizzare le impostazioni di sicurezza specificate nel parametro Sddl. Se il parametro ExactMatch è impostato su
True, le impostazioni di sicurezza in Sddl vengono utilizzate solo per autorizzare i tentativi di accesso all'URI esattamente secondo quanto specificato dall'URI.
Se ExactMatch è impostato su False, le impostazioni di sicurezza in Sddl vengono utilizzate per autorizzare i tentativi di accesso agli URI che iniziano
con la stringa specificata nell'URI.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.Object È possibile reindirizzare un valore per il nuovo elemento al cmdlet New-Item. |
Output |
Any |
Note
Il cmdlet New-Item è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PsProvider". Per ulteriori informazioni, vedere About_Providers.
Esempio 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)" Questo comando crea una voce di sicurezza nella directory Security della risorsa specifica Resource_5967683.
Vedere anche