Add-PASApplication
Add-PASApplication
SYNOPSIS
Adds a new application to the Vault
SYNTAX
Add-PASApplication [-AppID] <String> [[-Description] <String>] [-Location] <String>
[[-AccessPermittedFrom] <Int32>] [[-AccessPermittedTo] <Int32>] [[-ExpirationDate] <DateTime>]
[[-Disabled] <Boolean>] [[-BusinessOwnerFName] <String>] [[-BusinessOwnerLName] <String>]
[[-BusinessOwnerEmail] <String>] [[-BusinessOwnerPhone] <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Adds a new application to the Vault.
Manage Users permission is required.
EXAMPLES
EXAMPLE 1
Add-PASApplication -AppID NewApp -Description "A new application" -Location "\" `
-AccessPermittedFrom 9 -AccessPermittedTo 17 -BusinessOwnerEmail 'appowner@company.com'
Will add a new application called “NewApp”, in the root location, accessible from 9am to 5pm
EXAMPLE 2
Add-PASApplication -AppID FinanceApp -Location "\Applications\Finance" -ExpirationDate (Get-Date).AddYears(1) -Disabled $false -BusinessOwnerFName John -BusinessOwnerLName Smith -BusinessOwnerEmail 'john.smith@company.com' -BusinessOwnerPhone '555-0100'
Adds a new application called “FinanceApp” in the Finance vault location, with an expiration date one year from today and business owner contact details recorded against the application.
EXAMPLE 3
Import-Csv .\NewApplications.csv | Add-PASApplication
Adds a new application for every row in NewApplications.csv, where the CSV column headers match the parameter names of Add-PASApplication (AppID, Location, Description, etc).
PARAMETERS
-AppID
The application name.
Must be fewer than 128 characters.
Cannot include ampersand (“&”) character.
Can include “@” character, but any searches for applications cannot include this character.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Description
Description of the application, no longer than 99 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Location
The location of the application in the vault hierarchy.
Note: to insert a backslash in the location path, use a double backslash.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-AccessPermittedFrom
The start hour that access is permitted to the application.
Valid values are 0-23.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-AccessPermittedTo
The end hour that access to the application is permitted.
Valid values are 0-23.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ExpirationDate
The date when the application expires.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Disabled
Boolean value, denoting if the application is disabled or not.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 7
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-BusinessOwnerFName
The first name of the business owner.
Specify up to 29 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 8
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-BusinessOwnerLName
The last name of the business owner.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 9
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-BusinessOwnerEmail
The email address of the business owner
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 10
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-BusinessOwnerPhone
The phone number of the business owner.
Specify up to 24 characters.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 11
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.