Criando um compartilhamento com permissões com o Windows Powershell

Question

Usando o Powershell como posso criar um compartilhamento e definir permissões de acesso.

Por exemplo, da seguinte forma

• Criar compartilhamento chamado "público" que mapeia para o "caminho c: \ compartilhamentos \ foo"
• Permitir que DOMAIN1 \ Users tenham acesso somente leitura ao compartilhamento (isso não significa definir acls nos arquivos, mas no compartilhamento)

Answer 1

Isso deve funcionar:

net share "Public=c:\shares\foo" "/GRANT:Users,READ"

É claro que você precisará lançar o PowerShell com direitos administrativos, dependendo de onde / como você está fazendo isso.

    

Answer 2

Use o método Create do Win32_Share. Exemplo:

(Get-WmiObject -List -ComputerName . | Where-Object -FilterScript 
{$_.Name -eq "Win32_Share"}).InvokeMethod("Create",
   ("C:\FolderToShare","ShareName",0,100,"Share description"))

Você pode encontrar a documentação desse método aqui no MSDN .

uint32 Create(
  [in]  string Path,
  [in]  string Name,
  [in]  uint32 Type,
  [in]  uint32 MaximumAllowed,
  [in]  string Description,
  [in]  string Password,
  [in]  Win32_SecurityDescriptor Access
);

Parâmetros:

• Caminho - Caminho local do compartilhamento do Windows. Por exemplo, "C: \ FolderToShare".
• Nome - Passa o alias para um caminho configurado como um compartilhamento em um sistema Windows. Exemplo, "ShareName".
• Tipo - Passa o tipo de recurso que está sendo compartilhado. Os tipos incluem unidades de disco, filas de impressão, comunicações interprocessuais (IPC) e dispositivos gerais. Pode ser um dos seguintes valores.
  • 0 - Unidade de disco
  • 1 - Fila de impressão
  • 2 - Dispositivo
  • 3 - IPC
  • 2147483648 - Administrador da unidade de disco
  • 2147483649 - Admin da fila de impressão
  • 2147483650 - Administrador de dispositivos
  • 2147483651 - Admin do IPC
• MaximumAllowed - Limite do número máximo de usuários permitido para uso simultâneo deste recurso. Exemplo: 100. Este parâmetro é opcional.
• Descrição - Comentário opcional para descrever o recurso que está sendo compartilhado. Este parâmetro é opcional. Exemplo: "Descrição da partilha".
• Senha - Senha (quando o servidor está sendo executado com segurança em nível de compartilhamento) para o recurso compartilhado. Se o servidor estiver executando com segurança no nível do usuário, esse parâmetro será ignorado. Este parâmetro é opcional.
• Access - Descritor de segurança para permissões no nível do usuário. Um descritor de segurança contém informações sobre as permissões, o proprietário e os recursos de acesso do recurso.

Consulte esta página no MSDN para obter detalhes sobre como definir permissões de acesso: Classe Win32_SecurityDescriptor . Este artigo também é um bom ponto de partida: Tarefas do WMI: arquivos e pastas .

    

Answer 3

A função abaixo é um exemplo e pode ser adaptada para o que você precisar. Conforme escrito, ele espera um objeto DirectoryInfo como argumento, mas não seria difícil adaptá-lo para strings. O exemplo inclui permissões na pasta para dois objetos diferentes (um usuário e um grupo), cada um com diferentes tipos de acesso, para que você possa ver como misturar e combinar requisitos de permissão complexos:

# $folder is a DirectoryInfo object
Function Create-FileShare($folder)
{
    $name = $folder.Name
    $path = $folder.FullName
    $description = "$name"
    $domain = "example.com" #AD Domain name here (Optional/Not really used/Here for completeness)

    $Method = "Create"
    $sd = ([WMIClass] "Win32_SecurityDescriptor").CreateInstance()

    #AccessMasks:
    #2032127 = Full Control
    #1245631 = Change
    #1179817 = Read

    #Share with the user
    $ACE = ([WMIClass] "Win32_ACE").CreateInstance()
    $Trustee = ([WMIClass] "Win32_Trustee").CreateInstance()
    $Trustee.Name = $name
    $Trustee.Domain = $Null
    #original example assigned this, but I found it worked better if I left it empty
    #$Trustee.SID = ([wmi]"win32_userAccount.Domain='$domain',Name='$name'").sid    
    $ace.AccessMask = 1245631 
    $ace.AceFlags = 3 #Should almost always be three. Really. don't change it.
    $ace.AceType = 0 # 0 = allow, 1 = deny
    $ACE.Trustee = $Trustee 
    $sd.DACL += $ACE.psObject.baseobject 

    #Share with Domain Admins
    $ACE = ([WMIClass] "Win32_ACE").CreateInstance()
    $Trustee = ([WMIClass] "Win32_Trustee").CreateInstance()
    $Trustee.Name = "Domain Admins"
    $Trustee.Domain = $Null
    #$Trustee.SID = ([wmi]"win32_userAccount.Domain='$domain',Name='$name'").sid    
    $ace.AccessMask = 2032127
    $ace.AceFlags = 3
    $ace.AceType = 0
    $ACE.Trustee = $Trustee 
    $sd.DACL += $ACE.psObject.baseobject        

    $mc = [WmiClass]"Win32_Share"
    $InParams = $mc.psbase.GetMethodParameters($Method)
    $InParams.Access = $sd
    $InParams.Description = $description
    $InParams.MaximumAllowed = $Null
    $InParams.Name = $name
    $InParams.Password = $Null
    $InParams.Path = $path
    $InParams.Type = [uint32]0

    $R = $mc.PSBase.InvokeMethod($Method, $InParams, $Null)
    switch ($($R.ReturnValue))
     {
          0 {Write-Host "Share:$name Path:$path Result:Success"; break}
          2 {Write-Host "Share:$name Path:$path Result:Access Denied" -foregroundcolor red -backgroundcolor yellow;break}
          8 {Write-Host "Share:$name Path:$path Result:Unknown Failure" -foregroundcolor red -backgroundcolor yellow;break}
          9 {Write-Host "Share:$name Path:$path Result:Invalid Name" -foregroundcolor red -backgroundcolor yellow;break}
          10 {Write-Host "Share:$name Path:$path Result:Invalid Level" -foregroundcolor red -backgroundcolor yellow;break}
          21 {Write-Host "Share:$name Path:$path Result:Invalid Parameter" -foregroundcolor red -backgroundcolor yellow;break}
          22 {Write-Host "Share:$name Path:$path Result:Duplicate Share" -foregroundcolor red -backgroundcolor yellow;break}
          23 {Write-Host "Share:$name Path:$path Result:Reedirected Path" -foregroundcolor red -backgroundcolor yellow;break}
          24 {Write-Host "Share:$name Path:$path Result:Unknown Device or Directory" -foregroundcolor red -backgroundcolor yellow;break}
          25 {Write-Host "Share:$name Path:$path Result:Network Name Not Found" -foregroundcolor red -backgroundcolor yellow;break}
          default {Write-Host "Share:$name Path:$path Result:*** Unknown Error ***" -foregroundcolor red -backgroundcolor yellow;break}
     }
}

O script deve ser executado como administrador na máquina em que os compartilhamentos estão hospedados.

    

Answer 4

Este tópico , começando com a segunda resposta, tem alguns exemplos de script para fazer isso.