Classe Win32_Share
A classe Win32_Share representa um recurso compartilhado em um sistema de computador que executa o Windows. Pode ser uma unidade de disco, impressora, comunicação entre processos ou outro dispositivo compartilhável. Para obter mais informações sobre como recuperar classes WMI, consulte Recuperando uma classe.
A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.
Sintaxe
[Dynamic, Provider("CIMWin32"), UUID("{8502C4D6-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), AMENDMENT]
class Win32_Share : CIM_LogicalElement
{
string Caption;
string Description;
datetime InstallDate;
string Status;
uint32 AccessMask;
boolean AllowMaximum;
uint32 MaximumAllowed;
string Name;
string Path;
uint32 Type;
};
Membros
A classe Win32_Share tem estes tipos de membros:
Métodos
A classe Win32_Share tem esses métodos.
| Método | Descrição |
|---|---|
| Criar | Método de classe que inicia o compartilhamento para um recurso de servidor. |
| Excluir | Método de classe que exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor, desconectando conexões com o recurso compartilhado. |
| GetAccessMask | Retorna os direitos de acesso ao compartilhamento mantido pelo usuário ou grupo em cujo nome a instância é retornada. Você deve usar esse método no lugar da propriedade AccessMask , que é sempre NULL. |
| SetShareInfo | Método de classe que define os parâmetros de um recurso compartilhado. |
Propriedades
A classe Win32_Share tem essas propriedades.
-
AccessMask
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: PRETERIDO
Essa propriedade está obsoleta e não é mais usada. Em vez disso, use o método Win32_Share.GetAccessMask . O valor da propriedade AccessMask é definido como nulo pelo WMI. Para obter mais informações sobre como definir o acesso quando um compartilhamento é criado, consulte o método Create .
-
-
AllowMaximum
-
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_max_uses")
O número de usuários simultâneos para esse recurso foi limitado. Se True, o valor na propriedade MaximumAllowed será ignorado.
-
-
Legenda
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (64), DisplayName ("Caption")
Uma breve descrição textual do objeto.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
Descrição
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: DisplayName ("Description")
Uma descrição textual do objeto.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
InstallDate
-
-
Tipo de dados: datetime
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")
Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.
Essa propriedade é herdada de CIM_ManagedSystemElement.
-
-
MaximumAllowed
-
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_max_uses")
Limite o número máximo de usuários autorizados a usar esse recurso simultaneamente. O valor só será válido se a propriedade AllowMaximum estiver definida como FALSE.
-
-
Nome
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: key, Override ("Name"), MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_1|shi1_netname")
Alias fornecido a um caminho configurado como um compartilhamento em um sistema de computador que executa o Windows.
Exemplo do Windows 2008: "\SERVER01\public" – o Windows Server 2008 exige que você coloque o UNC no nome.
-
-
Caminho
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_path")
Caminho local do compartilhamento do Windows.
Exemplo: "C:\Program Files"
-
-
Status
-
-
Tipo de dados: cadeia de caracteres
-
Tipo de acesso: Somente leitura
-
Qualificadores: MaxLen (10), DisplayName ("Status")
Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. As status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).
As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.
Essa propriedade é herdada de CIM_ManagedSystemElement.
Os valores incluem o seguinte:
-
-
OK ("OK")
-
Erro ("Erro")
-
Degradado ("Degradado")
-
Desconhecido ("Desconhecido")
-
Pred Fail ("Pred Fail")
-
Iniciando ("Iniciando")
-
Parando ("Parando")
-
Serviço ("Serviço")
-
Estressado ("Estressado")
-
NonRecover ("NonRecover")
-
Sem Contato ("Sem Contato")
-
Lost Comm ("Lost Comm")
Tipo
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
-
Qualificadores: MappingStrings ("Win32API| Estruturas de gerenciamento de rede| SHARE_INFO_502|shi502_type")
Tipo de recurso que está sendo compartilhado. Os tipos incluem: unidades de disco, filas de impressão, IPC (comunicação entre processos) e dispositivos gerais.
Unidade de disco (0)
Fila de Impressão (1)
Dispositivo (2)
IPC (3)
Administração de unidade de disco (2147483648)
Administração de Fila de Impressão (2147483649)
Administração de dispositivo (2147483650)
IPC Administração (2147483651)
Comentários
A classe Win32_Share é derivada de CIM_LogicalElement.
O método Create nessa classe é um método estático. Os métodos Delete, GetAccessMask e SetShareInfo são todos métodos de instância.
Dependendo de suas permissões de segurança, talvez você não consiga recuperar todas as propriedades dessa classe. Por exemplo, as propriedades AllowMaximum, MaximumAllowed, Path e Type podem retornar nulo. De um modo geral, os Usuários avançados e administradores poderão recuperar todos os valores de propriedade.
Exemplos
Oexemplo de código da Central de Scripts a seguir lista todos os compartilhamentos em um computador e lista todas as permissões de compartilhamento para cada compartilhamento.
As consultas de exemplo Obter Informações de Compartilhamento semelhantes a Win32_Share PowerShell Win32_Share e fornece os resultados.
O exemplo do PowerShell a seguir exibe os compartilhamentos no sistema local.
$shares = Get-WMIObject -class Win32_share
"Shares on : {0}" -f $((gwmi win32_computersystem).name)
$shares | sort name | ft -auto
Como alternativa, se você quiser filtrar com mais precisão, poderá usar o seguinte snippet do PowerShell:
gwmi -q "SELECT * FROM Win32_Share WHERE Name != 'ADMIN$' AND Name != 'IPC$'"
O exemplo VBScript a seguir exibe os compartilhamentos no sistema local.
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2")
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_Share")
For Each objItem in colItems
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "Caption: " & objItem.Caption & "=" & objItem.Path
Next
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
Confira também
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários