FileSystemAuditRule Construtores
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe FileSystemAuditRule.
FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags) |
Inicializa uma nova instância da classe FileSystemAuditRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria e um valor que indica quando executar a auditoria. |
FileSystemAuditRule(String, FileSystemRights, AuditFlags) |
Inicializa uma nova instância da classe FileSystemAuditRule usando um nome conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria e um valor que indica quando executar a auditoria. |
FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags) |
Inicializa uma nova instância da classe FileSystemAuditRule usando o nome de uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica quando executar a auditoria. |
FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags) |
Inicializa uma nova instância da classe FileSystemAuditRule usando o nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica quando executar a auditoria. |
Inicializa uma nova instância da classe FileSystemAuditRule usando uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria e um valor que indica quando executar a auditoria.
public:
FileSystemAuditRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AuditFlags flags);
public FileSystemAuditRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AuditFlags flags);
new System.Security.AccessControl.FileSystemAuditRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule
Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, flags As AuditFlags)
Parâmetros
- identity
- IdentityReference
Um objeto IdentityReference que encapsula uma referência a uma conta de usuário.
- fileSystemRights
- FileSystemRights
Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de auditoria.
- flags
- AuditFlags
Um dos valores AuditFlags que especifica quando executar a auditoria.
Exceções
O parâmetro identity
não é um objeto IdentityReference.
O parâmetro identity
é null
.
Uma enumeração incorreta foi passada para o parâmetro flags
.
- ou -
O valor None foi passado para o parâmetro flags
.
Comentários
Use esse construtor para criar uma regra de auditoria que você pode persistir usando a FileSecurity classe ou DirectorySecurity . As regras de auditoria determinam quando e como as ações executadas em objetos do sistema, como arquivos e pastas, são registradas.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5 |
Inicializa uma nova instância da classe FileSystemAuditRule usando um nome conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria e um valor que indica quando executar a auditoria.
public:
FileSystemAuditRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AuditFlags flags);
public FileSystemAuditRule (string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AuditFlags flags);
new System.Security.AccessControl.FileSystemAuditRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule
Public Sub New (identity As String, fileSystemRights As FileSystemRights, flags As AuditFlags)
Parâmetros
- identity
- String
O nome de uma conta de usuário.
- fileSystemRights
- FileSystemRights
Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de auditoria.
- flags
- AuditFlags
Um dos valores AuditFlags que especifica quando executar a auditoria.
Exceções
Uma enumeração incorreta foi passada para o parâmetro flags
.
- ou -
O valor None foi passado para o parâmetro flags
.
Exemplos
O exemplo de código a seguir usa a FileSystemAuditRule classe para adicionar e remover uma regra de auditoria de um arquivo. Você deve fornecer uma conta de grupo ou de usuário válida para executar este exemplo.
using System;
using System.IO;
using System.Security.AccessControl;
namespace FileSystemExample
{
class FileExample
{
public static void Main()
{
try
{
string FileName = "test.xml";
Console.WriteLine("Adding access control entry for " + FileName);
// Add the access control entry to the file.
AddFileAuditRule(FileName, @"MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure);
Console.WriteLine("Removing access control entry from " + FileName);
// Remove the access control entry from the file.
RemoveFileAuditRule(FileName, @"MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure);
Console.WriteLine("Done.");
}
catch (IOException e)
{
Console.WriteLine("Unable to open the file: " + e.Message);
}
catch (PrivilegeNotHeldException e)
{
Console.WriteLine("The current account does not have the correct privileges: " + e.Message);
}
Console.ReadLine();
}
// Adds an ACL entry on the specified file for the specified account.
public static void AddFileAuditRule(string FileName, string Account, FileSystemRights Rights, AuditFlags AuditRule)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity fSecurity = File.GetAccessControl(FileName);
// Add the FileSystemAuditRule to the security settings.
fSecurity.AddAuditRule(new FileSystemAuditRule(Account,
Rights,
AuditRule));
// Set the new access settings.
File.SetAccessControl(FileName, fSecurity);
}
// Removes an ACL entry on the specified file for the specified account.
public static void RemoveFileAuditRule(string FileName, string Account, FileSystemRights Rights, AuditFlags AuditRule)
{
// Get a FileSecurity object that represents the
// current security settings.
FileSecurity fSecurity = File.GetAccessControl(FileName);
// Add the FileSystemAuditRule to the security settings.
fSecurity.RemoveAuditRule(new FileSystemAuditRule(Account,
Rights,
AuditRule));
// Set the new access settings.
File.SetAccessControl(FileName, fSecurity);
}
}
}
Imports System.IO
Imports System.Security.AccessControl
Module FileExample
Sub Main()
Try
Dim FileName As String = "test.xml"
Console.WriteLine("Adding access control entry for " + FileName)
' Add the access control entry to the file.
AddFileAuditRule(FileName, "MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure)
Console.WriteLine("Removing access control entry from " + FileName)
' Remove the access control entry from the file.
RemoveFileAuditRule(FileName, "MYDOMAIN\MyAccount", FileSystemRights.ReadData, AuditFlags.Failure)
Console.WriteLine("Done.")
Catch e As IOException
Console.WriteLine("Unable to open the file: " & e.Message)
Catch e As PrivilegeNotHeldException
Console.WriteLine("The current account does not have the correct privileges: " & e.Message)
End Try
Console.ReadLine()
End Sub
' Adds an ACL entry on the specified file for the specified account.
Sub AddFileAuditRule(ByVal FileName As String, ByVal Account As String, ByVal Rights As FileSystemRights, ByVal AuditRule As AuditFlags)
' Get a FileSecurity object that represents the
' current security settings.
Dim fSecurity As FileSecurity = File.GetAccessControl(FileName)
' Add the FileSystemAuditRule to the security settings.
fSecurity.AddAuditRule(New FileSystemAuditRule(Account, Rights, AuditRule))
' Set the new access settings.
File.SetAccessControl(FileName, fSecurity)
End Sub
' Removes an ACL entry on the specified file for the specified account.
Sub RemoveFileAuditRule(ByVal FileName As String, ByVal Account As String, ByVal Rights As FileSystemRights, ByVal AuditRule As AuditFlags)
' Get a FileSecurity object that represents the
' current security settings.
Dim fSecurity As FileSecurity = File.GetAccessControl(FileName)
' Add the FileSystemAuditRule to the security settings.
fSecurity.RemoveAuditRule(New FileSystemAuditRule(Account, Rights, AuditRule))
' Set the new access settings.
File.SetAccessControl(FileName, fSecurity)
End Sub
End Module
Comentários
Use esse construtor para criar uma regra de auditoria que você pode persistir usando a FileSecurity classe ou DirectorySecurity . As regras de auditoria determinam quando e como as ações executadas em objetos do sistema, como arquivos e pastas, são registradas.
O identity
parâmetro deve identificar uma conta válida no computador ou domínio atual. A cadeia de caracteres assume o seguinte formato, em DOMAIN
que é o nome de um domínio ou nome de computador válido e account
é o nome de uma conta de usuário válida em um domínio ou computador: DOMAIN\account
.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5 |
FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)
Inicializa uma nova instância da classe FileSystemAuditRule usando o nome de uma referência a uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica quando executar a auditoria.
public:
FileSystemAuditRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);
public FileSystemAuditRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);
new System.Security.AccessControl.FileSystemAuditRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule
Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags)
Parâmetros
- identity
- IdentityReference
Um objeto IdentityReference que encapsula uma referência a uma conta de usuário.
- fileSystemRights
- FileSystemRights
Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de auditoria.
- inheritanceFlags
- InheritanceFlags
Um dos valores InheritanceFlags que especificam como as máscaras de acesso são propagadas para objetos filho.
- propagationFlags
- PropagationFlags
Um dos valores PropagationFlags que especificam como as ACEs (Entradas de Controle de Acesso) são propagadas para objetos filho.
- flags
- AuditFlags
Um dos valores AuditFlags que especifica quando executar a auditoria.
Exceções
O parâmetro identity
não é um objeto IdentityReference.
O parâmetro identity
é null
.
Uma enumeração incorreta foi passada para o parâmetro flags
.
- ou -
O valor None foi passado para o parâmetro flags
.
Comentários
Use esse construtor para criar uma regra de auditoria que você pode persistir usando a FileSecurity classe ou DirectorySecurity . As regras de auditoria determinam quando e como as ações executadas em objetos do sistema, como arquivos e pastas, são registradas.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5 |
Inicializa uma nova instância da classe FileSystemAuditRule usando o nome de uma conta de usuário, um valor que especifica o tipo de operação associado à regra de auditoria, um valor que determina como os direitos são herdados, um valor que determina como os direitos são propagados e um valor que especifica quando executar a auditoria.
public:
FileSystemAuditRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AuditFlags flags);
public FileSystemAuditRule (string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AuditFlags flags);
new System.Security.AccessControl.FileSystemAuditRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AuditFlags -> System.Security.AccessControl.FileSystemAuditRule
Public Sub New (identity As String, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, flags As AuditFlags)
Parâmetros
- identity
- String
O nome de uma conta de usuário.
- fileSystemRights
- FileSystemRights
Um dos valores FileSystemRights que especifica o tipo de operação associada à regra de auditoria.
- inheritanceFlags
- InheritanceFlags
Um dos valores InheritanceFlags que especificam como as máscaras de acesso são propagadas para objetos filho.
- propagationFlags
- PropagationFlags
Um dos valores PropagationFlags que especificam como as ACEs (Entradas de Controle de Acesso) são propagadas para objetos filho.
- flags
- AuditFlags
Um dos valores AuditFlags que especifica quando executar a auditoria.
Comentários
Use esse construtor para criar uma regra de auditoria que você pode persistir usando a FileSecurity classe ou DirectorySecurity . As regras de auditoria determinam quando e como as ações executadas em objetos do sistema, como arquivos e pastas, são registradas.
O identity
parâmetro deve identificar uma conta válida no computador ou domínio atual. A cadeia de caracteres assume o seguinte formato, em DOMAIN
que é o nome de um domínio ou nome de computador válido e account
é o nome de uma conta de usuário válida em um domínio ou computador: DOMAIN\account
.
Aplica-se a
.NET 9 e outras versões
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: