Skip to content

Commit

Permalink
updates
Browse files Browse the repository at this point in the history
  • Loading branch information
James Smith committed Dec 8, 2020
1 parent 17dd581 commit 3029853
Show file tree
Hide file tree
Showing 21 changed files with 121 additions and 40 deletions.
43 changes: 29 additions & 14 deletions Docs/Cmdlets/Add-NTFSAudit.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Add auditing to a folder or files.
Add auditing to a folder or file.

## SYNTAX

Expand Down Expand Up @@ -42,23 +42,24 @@ Add-NTFSAudit [-SecurityDescriptor] <FileSystemSecurity2[]> [-Account] <Identity

## DESCRIPTION

{{ Fill in the Description }}
You can apply audit policies to individual files and folders on your computer by setting the permission type to record successful access attempts or failed access attempts in the security log.

To complete this procedure, you must be signed in as a member of the built-in Administrators group or have Manage auditing and security log rights.

## EXAMPLES

### Example 1

```PowerShell
PS C:\> {{ Add example code here }}
PS C:\> Add-NTFSAudit -Path C:\Data -Account 'NT AUTHORITY\Authenticated Users' -AcessRights generic All -AuditFlags Failure
```

{{ Add example description here }}

The above command adds auditing to the folder C:\Data on any failure.
## PARAMETERS

### -AccessRights

{{ Fill AccessRights Description }}
The AccessRights parameter designates the permissions to monitor or audit. There are individual permissions as well as 'basic' permissions. See the below table for how the basic permissions permissions map the the advanced permissions in the advanced security window.

```yaml
Type: FileSystemRights2
Expand All @@ -75,7 +76,7 @@ Accept wildcard characters: False
### -Account
{{ Fill Account Description }}
The Account parameter defines the account or group to apply the auditing to.
```yaml
Type: IdentityReference2[]
Expand All @@ -91,7 +92,7 @@ Accept wildcard characters: False
### -AppliesTo
{{ Fill AppliesTo Description }}
The AppliesTo parameter defines where the auditing will apply to and if there is any inheritance e.g "this folder only" or "this folder and subfolders".
```yaml
Type: ApplyTo
Expand All @@ -108,7 +109,7 @@ Accept wildcard characters: False
### -AuditFlags
{{ Fill AuditFlags Description }}
The AuditFlags parameter defines what types of events will be audited. If you would only like to audit denied access you would choose failure.
```yaml
Type: AuditFlags
Expand All @@ -125,7 +126,13 @@ Accept wildcard characters: False
### -InheritanceFlags
{{ Fill InheritanceFlags Description }}
The InheritanceFlags parameter defines the inheritance of the auditing.
ObjectInherit will apply the auditing to files and folders in the folder defined by the Path parameter.
ContainerInherit will apply the auditing to subfolders but not files.
There is more information on Microsoft Docs [here](https://docs.microsoft.com/en-us/previous-versions/dotnet/netframework-4.0/ms229747(v=vs.100)?redirectedfrom=MSDN)
```yaml
Type: InheritanceFlags
Expand All @@ -142,7 +149,7 @@ Accept wildcard characters: False
### -PassThru
{{ Fill PassThru Description }}
The PassThru parameter will return the new auditing as a table. If the PassThru parameter is omitted, there is no information returned if the operation was successful.
```yaml
Type: SwitchParameter
Expand All @@ -158,7 +165,7 @@ Accept wildcard characters: False
### -Path
{{ Fill Path Description }}
The Path parameter defines where the file or container exists to apply the auditing to.
```yaml
Type: String[]
Expand All @@ -174,7 +181,13 @@ Accept wildcard characters: False
### -PropagationFlags
{{ Fill PropagationFlags Description }}
The PropagationFlags parameter defines how the auditing is propagated to child objects.
Inherit specifies that the auditing is propagated only to child objects. This includes both folder and file child objects.
NoPropagateInherit specifies that the auditing is not propagated to child objects.
None specifies that no inheritance flags are set.
```yaml
Type: PropagationFlags
Expand All @@ -191,7 +204,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
14 changes: 8 additions & 6 deletions Docs/Cmdlets/Clear-NTFSAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

{{ Fill in the Synopsis }}
Removes all access control entries from a file or folder.

## SYNTAX

Expand All @@ -32,16 +32,16 @@ Clear-NTFSAccess [-SecurityDescriptor] <FileSystemSecurity2[]> [-DisableInherita
### Example 1

```PowerShell
PS C:\> {{ Add example code here }}
PS C:\> Clear-NTFSAccess -Path C:\Data\ -DisableInheritance
```

{{ Add example description here }}
The above example would remove all access control entries from the folder C:\Data and disable inheritance on the folder as well.

## PARAMETERS

### -DisableInheritance

{{ Fill DisableInheritance Description }}
The DisableInheritance parameter defines if you would like to didable the inheritance on the file or folder when clearing permissions.

```yaml
Type: SwitchParameter
Expand All @@ -57,7 +57,7 @@ Accept wildcard characters: False
### -Path
{{ Fill Path Description }}
The Path parameter defines where the file or container exists to remove the access control entries from.
```yaml
Type: String[]
Expand All @@ -73,7 +73,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Clear-NTFSAudit.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Disable-NTFSAccessInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Disable-NTFSAuditInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Enable-NTFSAccessInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Enable-NTFSAuditInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSAudit.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSEffectiveAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSOrphanedAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSOrphanedAudit.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSOwner.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Get-NTFSSimpleAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
32 changes: 30 additions & 2 deletions Docs/Cmdlets/Get-Privileges.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,38 @@ Get-Privileges [<CommonParameters>]
### Example 1

```PowerShell
PS C:\> {{ Add example code here }}
PS C:\> Get-Privileges
-------------------------------------------------------------------------
| Privilege | PrivilegeAttributes | PriviliegeState |
|-------------------------------|---------------------|-----------------|
| IncreaseQuota | Disabled | Disabled |
| Security | Enabled | Enabled |
| TakeOwnership | Enabled | Enabled |
| LoadDriver | Disabled | Disabled |
| SystemProfile | Disabled | Disabled |
| SystemTime | Disabled | Disabled |
| ProfileSingleProcess | Disabled | Disabled |
| IncreaseBasePriority | Disabled | Disabled |
| CreatePageFile | Disabled | Disabled |
| Backup | Enabled | Enabled |
| Restore | Enabled | Enabled |
| Shutdown | Disabled | Disabled |
| Debug | Enabled | Enabled |
| SystemEnvironment | Disabled | Disabled |
| ChangeNotify EnabledByDefault | Enabled | Enabled |
| RemoteShutdown | Disabled | Disabled |
| Undock | Disabled | Disabled |
| ManageVolume | Disabled | Disabled |
| Impersonate EnabledByDefault | Enabled | Enabled |
| CreateGlobal EnabledByDefault | Enabled | Enabled |
| IncreaseWorkingSet | Disabled | Disabled |
| TimeZone | Disabled | Disabled |
| CreateSymbolicLink | Disabled | Disabled |
-------------------------------------------------------------------------
```

{{ Add example description here }}
The above command gets the privliges.

## PARAMETERS

Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Remove-NTFSAccess.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Remove-NTFSAudit.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
4 changes: 3 additions & 1 deletion Docs/Cmdlets/Set-NTFSInheritance.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,9 @@ Accept wildcard characters: False
### -SecurityDescriptor
{{ Fill SecurityDescriptor Description }}
The SecurityDescriptor parameter allows passing an security descriptor or an array or security descriptors.
A security descriptor contains information about the owner of the object, and the primary group of an object. The security descriptor also contains two access control lists (ACL). The first list is called the discretionary access control lists (DACL), and describes who should have access to an object and what type of access to grant. The second list is called the system access control lists (SACL) and defines what type of auditing to record for an object.
```yaml
Type: FileSystemSecurity2[]
Expand Down
Loading

0 comments on commit 3029853

Please sign in to comment.