O gerenciamento de permissões de compartilhamentos SMB (Server Message Block) é uma tarefa comum para administradores de sistemas Windows. O PowerShell oferece um conjunto de cmdlets que facilitam essa tarefa, incluindo o cmdlet Grant-SmbShareAccess. Este artigo técnico fornecerá um guia completo sobre como usar este cmdlet para gerenciar acessos a compartilhamentos SMB, com exemplos práticos de scripts PowerShell.

Exemplos:

Exemplo 1: Criar um Compartilhamento SMB e Conceder Acesso

Vamos começar criando um compartilhamento SMB e concedendo acesso a um usuário específico.

# Criar um novo compartilhamento SMB
New-SmbShare -Name "PublicShare" -Path "C:\Public" -FullAccess "Everyone"

# Conceder acesso de leitura a um usuário específico
Grant-SmbShareAccess -Name "PublicShare" -AccountName "DOMAIN\User" -AccessRight Read

Exemplo 2: Conceder Acesso de Escrita a um Grupo

Neste exemplo, concederemos acesso de escrita a um grupo de segurança.

# Conceder acesso de escrita a um grupo de segurança
Grant-SmbShareAccess -Name "PublicShare" -AccountName "DOMAIN\ITGroup" -AccessRight Change

Exemplo 3: Verificar Permissões de Compartilhamento

Para verificar as permissões atuais de um compartilhamento, você pode usar o cmdlet Get-SmbShareAccess.

# Verificar permissões de compartilhamento
Get-SmbShareAccess -Name "PublicShare"

Exemplo 4: Remover Acesso de um Usuário

Para remover o acesso de um usuário a um compartilhamento SMB, use o cmdlet Revoke-SmbShareAccess.

# Remover acesso de um usuário
Revoke-SmbShareAccess -Name "PublicShare" -AccountName "DOMAIN\User"

Exemplo 5: Modificar Permissões de Acesso

Para modificar as permissões de um usuário ou grupo existente, use o cmdlet Set-SmbShareAccess.

# Modificar permissões de acesso para um usuário
Set-SmbShareAccess -Name "PublicShare" -AccountName "DOMAIN\User" -AccessRight Full

Exemplo 6: Script Completo para Gerenciar Compartilhamento SMB

Aqui está um script completo que cria um compartilhamento SMB, concede acesso a um grupo, verifica as permissões e, em seguida, remove o acesso de um usuário.

# Criar um novo compartilhamento SMB
New-SmbShare -Name "ProjectShare" -Path "C:\Projects" -FullAccess "Everyone"

# Conceder acesso de leitura a um grupo de segurança
Grant-SmbShareAccess -Name "ProjectShare" -AccountName "DOMAIN\ProjectTeam" -AccessRight Read

# Verificar permissões de compartilhamento
Get-SmbShareAccess -Name "ProjectShare"

# Remover acesso de um usuário
Revoke-SmbShareAccess -Name "ProjectShare" -AccountName "DOMAIN\OldUser"

# Modificar permissões de acesso para um usuário
Set-SmbShareAccess -Name "ProjectShare" -AccountName "DOMAIN\ProjectManager" -AccessRight Full