Set-ITGluePassword
SYNOPSIS
Updates one or more passwords
SYNTAX
Bulk_Update (Default)
Set-ITGluePassword -Data <Object> [-WhatIf] [-Confirm] [<CommonParameters>]
Update
Set-ITGluePassword [-OrganizationID <Int64>] -ID <Int64> [-ShowPassword <String>] -Data <Object> [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
The Set-ITGluePassword cmdlet updates the details of an existing password or the details of multiple passwords
To show passwords your API key needs to have the “Password Access” permission
Any attributes you don’t specify will remain unchanged
Examples of JSON objects can be found under ITGlues developer documentation https://api.itglue.com/developer
EXAMPLES
EXAMPLE 1
Set-ITGluePassword -id 8675309 -Data $JsonObject
Updates the password in the defined organization with the specified JSON object
The password is NOT returned in the results
EXAMPLE 2
Set-ITGluePassword -id 8675309 -ShowPassword $true -Data $JsonObject
Updates the password in the defined organization with the specified JSON object
The password IS returned in the results
PARAMETERS
-OrganizationID
A valid organization Id in your account
Type: Int64
Parameter Sets: Update
Aliases: org_id, organization_id
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-ID
Update a password by id
Type: Int64
Parameter Sets: Update
Aliases:
Required: True
Position: Named
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: Update
Aliases: show_Password
Required: False
Position: Named
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: 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
-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/Set-ITGluePassword.html