New-ITGluePassword
SYNOPSIS
Creates one or more a passwords
SYNTAX
New-ITGluePassword [[-OrganizationID] <Int64>] [[-ShowPassword] <String>] [-Data] <Object> [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
The New-ITGluePassword cmdlet creates one or more passwords under the organization specified in the ID parameter
To show passwords your API key needs to have the “Password Access” permission
You can create general and embedded passwords with this endpoint
If the resource-id and resource-type attributes are NOT provided, IT Glue assumes the password is a general password
If the resource-id and resource-type attributes are provided, IT Glue assumes the password is an embedded password
Examples of JSON objects can be found under ITGlues developer documentation https://api.itglue.com/developer
EXAMPLES
EXAMPLE 1
New-ITGluePassword -OrganizationID 8675309 -Data $JsonObject
Creates a new password in the defined organization with the specified JSON object
The password IS returned in the results
EXAMPLE 2
New-ITGluePassword -OrganizationID 8675309 -ShowPassword $false -Data $JsonObject
Creates a new password in the defined organization with the specified JSON object
The password is NOT returned in the results
PARAMETERS
-OrganizationID
A valid organization Id in your account
Type: Int64
Parameter Sets: (All)
Aliases: org_id, organization_id
Required: False
Position: 1
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-ShowPassword
Define if the password should be shown or not
By default ITGlue hides the passwords from the returned data
Allowed values: (case-sensitive) ‘true’, ‘false’
Type: String
Parameter Sets: (All)
Aliases: show_password
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Data
JSON object or array depending on bulk changes or not
Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
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
-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
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.
INPUTS
OUTPUTS
NOTES
N/A
RELATED LINKS
https://celerium.github.io/ITGlue-PowerShellWrapper/site/Passwords/New-ITGluePassword.html