Functions/AccountACL/Add-PASAccountACL.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
function Add-PASAccountACL {
    <#
.SYNOPSIS
Adds a new privileged command rule to an account.
 
.DESCRIPTION
Adds a new privileged command rule to an account.
 
.PARAMETER AccountPolicyId
The PolicyID associated with account.
 
.PARAMETER AccountAddress
The address of the account whose privileged commands will be listed.
 
.PARAMETER AccountUserName
The name of the account's user.
 
.PARAMETER Command
The Command
 
.PARAMETER CommandGroup
Boolean for Command Group
 
.PARAMETER PermissionType
Allow or Deny permission
 
.PARAMETER Restrictions
A restriction string
 
.PARAMETER UserName
The user this rule applies to
 
.EXAMPLE
Add-PASAccountACL -AccountPolicyID UNIXSSH -AccountAddress ServerA.domain.com -AccountUserName root `
        -Command 'for /l %a in (0,0,0) do xyz' -CommandGroup $false -PermissionType Deny -UserName TestUser
 
This will add a new Privileged Command Rule to root for user TestUser
 
.LINK
https://pspas.pspete.dev/commands/Add-PASAccountACL
#>

    [CmdletBinding()]
    param(
        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $true
        )]
        [Alias("PolicyID")]
        [Alias("PlatformID")]
        [ValidateNotNullOrEmpty()]
        [string]$AccountPolicyId,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $true
        )]
        [Alias("Address")]
        [ValidateNotNullOrEmpty()]
        [string]$AccountAddress,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $false
        )]
        [ValidateNotNullOrEmpty()]
        [string]$AccountUserName,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $false
        )]
        [ValidateNotNullOrEmpty()]
        [string]$Command,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $false
        )]
        [boolean]$CommandGroup,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $false
        )]
        [ValidateSet("Allow", "Deny")]
        [string]$PermissionType,

        [parameter(
            Mandatory = $false,
            ValueFromPipelinebyPropertyName = $false
        )]
        [ValidateNotNullOrEmpty()]
        [string]$Restrictions,

        [parameter(
            Mandatory = $true,
            ValueFromPipelinebyPropertyName = $false
        )]
        [ValidateNotNullOrEmpty()]
        [string]$UserName

    )

    BEGIN { }#begin

    PROCESS {

        #URL for request
        $URI = "$Script:BaseURI/WebServices/PIMServices.svc/Account/$($AccountAddress |
 
            Get-EscapedString)|$($AccountUserName |
 
                Get-EscapedString)|$($AccountPolicyId |
 
                    Get-EscapedString)/PrivilegedCommands"


        #Request body
        $Body = $PSBoundParameters |

        Get-PASParameter -ParametersToRemove AccountAddress, AccountUserName, AccountPolicyID |

        ConvertTo-Json

        #Send Request
        $result = Invoke-PASRestMethod -Uri $URI -Method PUT -Body $Body -WebSession $Script:WebSession

        if ($result) {

            $result.AddAccountPrivilegedCommandResult |

            Add-ObjectDetail -typename psPAS.CyberArk.Vault.ACL.Account

        }

    }#process

    END { }#end

}