exports/Update-SysManPrinter.ps1
|
<# .Synopsis Partially updates a existing Printer. Does not require all attributes to be set. Note that only attribute not present in the payload will be ignored. Note: Attributes with null values will be treated as attribute assignments. .Description Partially updates a existing Printer. Does not require all attributes to be set. Note that only attribute not present in the payload will be ignored. Note: Attributes with null values will be treated as attribute assignments. .Link https://docs.microsoft.com/en-us/powershell/module/sysman.webapi/update-sysmanprinter #> function Update-SysManPrinter { [OutputType('SysMan.Powershell.Models.IPrinter', 'SysMan.Powershell.Models.IApiErrorMessage')] [CmdletBinding(DefaultParameterSetName='Patch', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')] [SysMan.Powershell.Description('Partially updates a existing Printer. Does not require all attributes to be set. Note that only attribute not present in the payload will be ignored. Note: Attributes with null values will be treated as attribute assignments.')] param( [Parameter(Mandatory, HelpMessage='The id of the Printer')] [SysMan.Powershell.Category('Path')] [System.Int64] ${Id}, [Parameter(ParameterSetName='Patch', ValueFromPipeline, HelpMessage='Partial update of a printer')] [SysMan.Powershell.Category('Body')] [SysMan.Powershell.Models.IBodyParameterPrinterPatchRequestBody] ${Cmd}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='If the printer can be assigned as default printer during installation')] [SysMan.Powershell.Category('Body')] [System.Management.Automation.SwitchParameter] ${CanBeDefault}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='If the printer can be removed. Usually used by external systems (example: Login script) to handle cases where theprinter should be removed each login and installed again.')] [SysMan.Powershell.Category('Body')] [System.Management.Automation.SwitchParameter] ${CanBeRemoved}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='The description of the printer')] [SysMan.Powershell.Category('Body')] [System.String] ${Description}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='If the printer is active or nor. Inactive printer can be used to filter out printers that should not be handled byusers')] [SysMan.Powershell.Category('Body')] [System.Management.Automation.SwitchParameter] ${IsActive}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='The location of the printer. Mostly used as meta data to help technicians which printer to pick when intalling themon clients')] [SysMan.Powershell.Category('Body')] [System.String] ${Location}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='The name. Often used together with Server to create a printer path')] [SysMan.Powershell.Category('Body')] [System.String] ${Name}, [Parameter(ParameterSetName='PatchExpanded', HelpMessage='The server. Often used together with Name to create a printer path')] [SysMan.Powershell.Category('Body')] [System.String] ${Server}, [Parameter(DontShow, HelpMessage='Wait for .NET debugger to attach')] [SysMan.Powershell.Category('Runtime')] [System.Management.Automation.SwitchParameter] ${Break}, [Parameter(DontShow, HelpMessage='SendAsync Pipeline Steps to be appended to the front of the pipeline')] [ValidateNotNull()] [SysMan.Powershell.Category('Runtime')] [SysMan.Powershell.Runtime.SendAsyncStep[]] ${HttpPipelineAppend}, [Parameter(DontShow, HelpMessage='SendAsync Pipeline Steps to be prepended to the front of the pipeline')] [ValidateNotNull()] [SysMan.Powershell.Category('Runtime')] [SysMan.Powershell.Runtime.SendAsyncStep[]] ${HttpPipelinePrepend}, [Parameter(DontShow, HelpMessage='The URI for the proxy server to use')] [SysMan.Powershell.Category('Runtime')] [System.Uri] ${Proxy}, [Parameter(DontShow, HelpMessage='Credentials for a proxy server to use for the remote call')] [ValidateNotNull()] [SysMan.Powershell.Category('Runtime')] [System.Management.Automation.PSCredential] ${ProxyCredential}, [Parameter(DontShow, HelpMessage='Use the default credentials for the proxy')] [SysMan.Powershell.Category('Runtime')] [System.Management.Automation.SwitchParameter] ${ProxyUseDefaultCredentials} ) begin { try { $outBuffer = $null if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) { $PSBoundParameters['OutBuffer'] = 1 } $parameterSet = $PsCmdlet.ParameterSetName $mapping = @{ Patch = 'SysMan.WebApi.private\Update-SysManPrinter_Patch'; PatchExpanded = 'SysMan.WebApi.private\Update-SysManPrinter_PatchExpanded'; Upgrade = 'SysMan.WebApi.private\Update-SysManPrinter_Upgrade'; } $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand(($mapping[$parameterSet]), [System.Management.Automation.CommandTypes]::Cmdlet) $scriptCmd = {& $wrappedCmd @PSBoundParameters} $steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin) $steppablePipeline.Begin($PSCmdlet) } catch { throw } } process { try { $steppablePipeline.Process($_) } catch { throw } } end { try { $steppablePipeline.End() } catch { throw } } } |