New-Item

Artigo
10/30/2009

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

Compartilhar via