Sdílet prostřednictvím


FileSystemAuditRule Konstruktory

Definice

Inicializuje novou instanci FileSystemAuditRule třídy .

Přetížení

FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí odkazu na uživatelský účet, hodnotu, která určuje typ operace přidružené k pravidlu auditu, a hodnotu, která určuje, kdy provést auditování.

FileSystemAuditRule(String, FileSystemRights, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu uživatelského účtu, hodnoty, která určuje typ operace přidružené k pravidlu auditu, a hodnotu, která určuje, kdy provést auditování.

FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu odkazu na uživatelský účet, hodnotu, která určuje typ operace přidružené k pravidlu auditu, hodnotu, která určuje způsob dědění práv, hodnotu určující způsob šíření práv a hodnotu, která určuje, kdy se má provést auditování.

FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu uživatelského účtu, hodnoty, která určuje typ operace přidružené k pravidlu auditu, hodnotu, která určuje způsob dědění práv, hodnotu určující způsob šíření práv a hodnotu, která určuje, kdy se má provést auditování.

FileSystemAuditRule(IdentityReference, FileSystemRights, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí odkazu na uživatelský účet, hodnotu, která určuje typ operace přidružené k pravidlu auditu, a hodnotu, která určuje, kdy provést auditování.

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)

Parametry

identity
IdentityReference

Objekt IdentityReference , který zapouzdřuje odkaz na uživatelský účet.

fileSystemRights
FileSystemRights

Jedna z FileSystemRights hodnot, která určuje typ operace přidružené k pravidlu auditu.

flags
AuditFlags

Jedna z AuditFlags hodnot, která určuje, kdy se má auditování provést.

Výjimky

Parametr identity není IdentityReference objekt.

Parametr identity je null.

Parametru byl předán flags nesprávný výčet.

-nebo-

Hodnota None byla předána parametru flags .

Poznámky

Pomocí tohoto konstruktoru můžete vytvořit pravidlo auditu, které můžete zachovat pomocí FileSecurity třídy nebo DirectorySecurity . Pravidla auditu určují, kdy a jak se protokolují akce prováděné se systémových objektů, jako jsou soubory a složky.

Platí pro

FileSystemAuditRule(String, FileSystemRights, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu uživatelského účtu, hodnoty, která určuje typ operace přidružené k pravidlu auditu, a hodnotu, která určuje, kdy provést auditování.

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)

Parametry

identity
String

Název uživatelského účtu.

fileSystemRights
FileSystemRights

Jedna z FileSystemRights hodnot, která určuje typ operace přidružené k pravidlu auditu.

flags
AuditFlags

Jedna z AuditFlags hodnot, která určuje, kdy se má auditování provést.

Výjimky

Parametru byl předán flags nesprávný výčet.

-nebo-

Hodnota None byla předána parametru flags .

Příklady

Následující příklad kódu používá FileSystemAuditRule třídu k přidání a odebrání pravidla auditu ze souboru. Abyste mohli tento příklad spustit, musíte zadat platný uživatelský nebo skupinový účet.

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

Poznámky

Pomocí tohoto konstruktoru můžete vytvořit pravidlo auditu, které můžete zachovat pomocí FileSecurity třídy nebo DirectorySecurity . Pravidla auditu určují, kdy a jak se protokolují akce prováděné se systémových objektů, jako jsou soubory a složky.

Parametr identity musí identifikovat platný účet v aktuálním počítači nebo doméně. Řetězec má následující tvar, kde DOMAIN je název platné domény nebo počítače a account je název platného uživatelského účtu v doméně nebo počítači: DOMAIN\account.

Platí pro

FileSystemAuditRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu odkazu na uživatelský účet, hodnotu, která určuje typ operace přidružené k pravidlu auditu, hodnotu, která určuje způsob dědění práv, hodnotu určující způsob šíření práv a hodnotu, která určuje, kdy se má provést auditování.

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)

Parametry

identity
IdentityReference

Objekt IdentityReference , který zapouzdřuje odkaz na uživatelský účet.

fileSystemRights
FileSystemRights

Jedna z FileSystemRights hodnot, která určuje typ operace přidružené k pravidlu auditu.

inheritanceFlags
InheritanceFlags

Jedna z InheritanceFlags hodnot, která určuje, jak se masky přístupu šíří do podřízených objektů.

propagationFlags
PropagationFlags

Jedna z PropagationFlags hodnot, která určuje, jak se Access Control položky (ACE) šíří do podřízených objektů.

flags
AuditFlags

Jedna z AuditFlags hodnot, která určuje, kdy se má auditování provést.

Výjimky

Parametr identity není IdentityReference objekt.

Parametr identity je null.

Parametru byl předán flags nesprávný výčet.

-nebo-

Hodnota None byla předána parametru flags .

Poznámky

Pomocí tohoto konstruktoru můžete vytvořit pravidlo auditu, které můžete zachovat pomocí FileSecurity třídy nebo DirectorySecurity . Pravidla auditu určují, kdy a jak se protokolují akce prováděné se systémových objektů, jako jsou soubory a složky.

Platí pro

FileSystemAuditRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AuditFlags)

Inicializuje novou instanci FileSystemAuditRule třídy pomocí názvu uživatelského účtu, hodnoty, která určuje typ operace přidružené k pravidlu auditu, hodnotu, která určuje způsob dědění práv, hodnotu určující způsob šíření práv a hodnotu, která určuje, kdy se má provést auditování.

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)

Parametry

identity
String

Název uživatelského účtu.

fileSystemRights
FileSystemRights

Jedna z FileSystemRights hodnot, která určuje typ operace přidružené k pravidlu auditu.

inheritanceFlags
InheritanceFlags

Jedna z InheritanceFlags hodnot, která určuje, jak se masky přístupu šíří do podřízených objektů.

propagationFlags
PropagationFlags

Jedna z PropagationFlags hodnot, která určuje, jak se Access Control položky (ACE) šíří do podřízených objektů.

flags
AuditFlags

Jedna z AuditFlags hodnot, která určuje, kdy se má auditování provést.

Poznámky

Pomocí tohoto konstruktoru můžete vytvořit pravidlo auditu, které můžete zachovat pomocí FileSecurity třídy nebo DirectorySecurity . Pravidla auditu určují, kdy a jak se protokolují akce prováděné se systémových objektů, jako jsou soubory a složky.

Parametr identity musí identifikovat platný účet v aktuálním počítači nebo doméně. Řetězec má následující tvar, kde DOMAIN je název platné domény nebo počítače a account je název platného uživatelského účtu v doméně nebo počítači: DOMAIN\account.

Platí pro