Compartilhar via


New-Item

Cria um novo item.

Sintaxe

New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet New-Item cria um novo item e define seu valor. Os tipos de itens que podem ser criados dependem do local do item. Por exemplo, no sistema de arquivos, New-Item é usado para criar arquivos e pastas. No Registro, New-Item cria entradas e chaves do Registro.

No diretório Security, você pode usar o cmdlet New-Item para criar e configurar a segurança do Plug-in.

Parâmetros

-URI <Uri>

Identifica o URI para o qual o acesso é autorizado com base no valor do parâmetro Sddl.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-SDDL <string>

Especifica uma SDDL (Security Descriptor Definition Language) para a entrada de controle de acesso. Identifica as configurações

de segurança usadas para autorizar o acesso a um URI de recurso especificado.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-ExactMatch

Especifica como usar as configurações de segurança especificadas no parâmetro Sddl. Se o parâmetro ExactMatch for definido como

True, as configurações de segurança em Sddl serão usadas apenas para autorizar tentativas de acesso ao URI exatamente como especificado pelo URI.

Se ExactMatch for definido como false, as configurações de segurança em Sddl serão usadas para autorizar tentativas de acesso aos URIs que começam com a cadeia de caracteres

especificada no URI.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Object

Também é possível canalizar um valor para o novo item ao cmdlet New-Item.

Saídas

Any

Observações

O cmdlet New-Item foi criado para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua seção, digite "Get-PsProvider". Para obter mais informações, consulte About_Providers.

Exemplo 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)"

Este comando cria uma entrada de segurança no diretório Security de Resource_5967683 (um recurso específico).





Consulte também

Conceitos

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