FileSystemAuditRule Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса FileSystemAuditRule.
Перегрузки
FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags) |
Инициализирует новый экземпляр класса FileSystemAuditRule, используя ссылку на учетную запись пользователя, значение, определяющее тип операции, связанной с правилом аудита, а также значение, определяющее условия проведения аудита. |
FileSystemAuditRule(String, FileSystemRights, AuditFlags) |
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя учетной записи пользователя, значение, определяющее тип операции, связанной с правилом аудита, а также значение, определяющее условия проведения аудита. |
FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags) |
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя ссылки на учетную запись пользователя, значение, определяющее тип связанных с правилом аудита операций, значение, определяющее порядок наследования прав, значение, определяющее порядок распространения прав, а также значение, обозначающее условия проведения аудита. |
FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags) |
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя учетной записи пользователя, значение, определяющее тип связанных с правилом аудита операций, значение, определяющее порядок наследования прав, значение, определяющее порядок распространения прав, а также значение, обозначающее условия проведения аудита. |
FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags)
Инициализирует новый экземпляр класса FileSystemAuditRule, используя ссылку на учетную запись пользователя, значение, определяющее тип операции, связанной с правилом аудита, а также значение, определяющее условия проведения аудита.
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)
Параметры
- identity
- IdentityReference
Объект IdentityReference, инкапсулирующий ссылку на учетную запись пользователя.
- fileSystemRights
- FileSystemRights
Одно из значений FileSystemRights, задающее тип операции, связанной с правилом аудита.
- flags
- AuditFlags
Одно из значений AuditFlags, задающее условия проведения аудита.
Исключения
Параметр identity
не является объектом IdentityReference.
Параметр identity
имеет значение null
.
Комментарии
Используйте этот конструктор для создания правила аудита, которое можно сохранить с помощью FileSecurity класса или DirectorySecurity . Правила аудита определяют, когда и как регистрируются действия, выполняемые с системными объектами, такими как файлы и папки.
Применяется к
FileSystemAuditRule(String, FileSystemRights, AuditFlags)
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя учетной записи пользователя, значение, определяющее тип операции, связанной с правилом аудита, а также значение, определяющее условия проведения аудита.
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)
Параметры
- identity
- String
Имя учетной записи пользователя.
- fileSystemRights
- FileSystemRights
Одно из значений FileSystemRights, задающее тип операции, связанной с правилом аудита.
- flags
- AuditFlags
Одно из значений AuditFlags, задающее условия проведения аудита.
Исключения
Примеры
В следующем примере кода класс используется для FileSystemAuditRule добавления и удаления правила аудита из файла. Для выполнения этого примера необходимо указать допустимую учетную запись пользователя или группы.
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
Комментарии
Используйте этот конструктор для создания правила аудита, которое можно сохранить с помощью FileSecurity класса или DirectorySecurity . Правила аудита определяют, когда и как регистрируются действия, выполняемые с системными объектами, такими как файлы и папки.
Параметр identity
должен идентифицировать действительную учетную запись на текущем компьютере или домене. Строка имеет следующий вид, где DOMAIN
— это имя допустимого домена или компьютера, а account
— имя допустимой учетной записи пользователя в домене или на компьютере: DOMAIN\account
.
Применяется к
FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя ссылки на учетную запись пользователя, значение, определяющее тип связанных с правилом аудита операций, значение, определяющее порядок наследования прав, значение, определяющее порядок распространения прав, а также значение, обозначающее условия проведения аудита.
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)
Параметры
- identity
- IdentityReference
Объект IdentityReference, инкапсулирующий ссылку на учетную запись пользователя.
- fileSystemRights
- FileSystemRights
Одно из значений FileSystemRights, задающее тип операции, связанной с правилом аудита.
- inheritanceFlags
- InheritanceFlags
Одно из значений InheritanceFlags, определяющее порядок распространения масок доступа на дочерние объекты.
- propagationFlags
- PropagationFlags
Одно из значений PropagationFlags, определяющее порядок распространения элементов управления доступом на дочерние объекты.
- flags
- AuditFlags
Одно из значений AuditFlags, задающее условия проведения аудита.
Исключения
Параметр identity
не является объектом IdentityReference.
Параметр identity
имеет значение null
.
Комментарии
Используйте этот конструктор для создания правила аудита, которое можно сохранить с помощью FileSecurity класса или DirectorySecurity . Правила аудита определяют, когда и как регистрируются действия, выполняемые с системными объектами, такими как файлы и папки.
Применяется к
FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)
Инициализирует новый экземпляр класса FileSystemAuditRule, используя имя учетной записи пользователя, значение, определяющее тип связанных с правилом аудита операций, значение, определяющее порядок наследования прав, значение, определяющее порядок распространения прав, а также значение, обозначающее условия проведения аудита.
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)
Параметры
- identity
- String
Имя учетной записи пользователя.
- fileSystemRights
- FileSystemRights
Одно из значений FileSystemRights, задающее тип операции, связанной с правилом аудита.
- inheritanceFlags
- InheritanceFlags
Одно из значений InheritanceFlags, определяющее порядок распространения масок доступа на дочерние объекты.
- propagationFlags
- PropagationFlags
Одно из значений PropagationFlags, определяющее порядок распространения элементов управления доступом на дочерние объекты.
- flags
- AuditFlags
Одно из значений AuditFlags, задающее условия проведения аудита.
Комментарии
Используйте этот конструктор для создания правила аудита, которое можно сохранить с помощью FileSecurity класса или DirectorySecurity . Правила аудита определяют, когда и как регистрируются действия, выполняемые с системными объектами, такими как файлы и папки.
Параметр identity
должен идентифицировать действительную учетную запись на текущем компьютере или домене. Строка имеет следующий вид, где DOMAIN
— это имя допустимого домена или компьютера, а account
— имя допустимой учетной записи пользователя в домене или на компьютере: DOMAIN\account
.