Set HPOVExternalRepository - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

Set-HPOVExternalRepository

Modify an existing external baseline repository.

SYNTAX

Set-HPOVExternalRepository [-InputObject] <Object> [-Name] <String>[ [-Username] <String>][ [-Password] <SecureString>][ [-Certificate] <String>][ [-Async] <SwitchParameter>] [-WhatIf] <> [-Confirm] <> [<CommonParameters>]

Set-HPOVExternalRepository [-InputObject] <Object> [-Name] <String> [-Credential] <String>[ [-Certificate] <String>][ [-Async] <SwitchParameter>] [-WhatIf] <> [-Confirm] <> [<CommonParameters>]

Set-HPOVExternalRepository[ [-ApplianceConnection] <Array>] [-WhatIf] <> [-Confirm] <> [<CommonParameters>]

Detailed Description

A firmware repository enables you to store firmware bundles and deploy them across your environment. An externally managed HTTP/HTTPS web server can be added to the appliance as a repository. It is a user-maintained HTTP/HTTPS web server. You can upload firmware bundles in a specific directory and then register the HTTP/HTTPS server with HPE OneView. This functionality is supported for Linux and Windows systems.

The recommended types of external web servers to use with the repository follow:

* Apache
* Internet Information Services (IIS)

NOTE: Only one external repository can be added.

This Cmdlet supports modifying an existing external repository. Use this Cmdlet to modify the Name, authentication credentials and/or HTTP SSL certificate.

Parameters

-ApplianceConnection <Array>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	false
Position?	named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Certificate <String>

The Base64 Certificate of the target web server. Must be specified if the -HTTP parameter is not used.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Confirm <>

Aliases	cf
Required?
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Credential <String>

Provide a PSCredential object if the target web server requires authentication. By default, HTTPS will be used and basic authentication is used to communicate with the target web server.

Aliases	None
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-InputObject <Object>

Provide the external repository object to modify.

Aliases	None
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Name <String>

Update the configured repository with the new name.

Aliases	None
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Password <SecureString>

Provide the password of the username using a SecureString.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Username <String>

Provide the username to authenticate to the target web server with if required.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-WhatIf <>

Aliases	wi
Required?
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPOneView.Appliance.BaselineRepository [System.Management.Automation.PSCustomObject]

The external repository object from Get-HPOVBaselineRepository

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

The async task for the caller to monitor.

System.Collections.ArrayList <HPOneView.Appliance.TaskResource>

Multiple async task resource objects.

Examples

-------------------------- EXAMPLE 1 --------------------------

Get-HPOVBaselineRepository -Name MyRepoName -ErrorAction Stop | Set-HPOVExternalRepository -Name UpdatedRepoName

Modify an existing external repository with a new name.

-------------------------- EXAMPLE 2 --------------------------

Get-HPOVBaselineRepository -Name MyRepoName MyRepoName -ErrorAction Stop | Set-HPOVExternalRepository -Credential (Get-PSCredential -Username "Domain\MyUpdatedAccountName")

Modify an existing repository with new credentials.

-------------------------- EXAMPLE 3 --------------------------

$UpdatedSslCertificate = Get-Content C:\Dir\UpdatedCert.cer -raw Get-HPOVBaselineRepository -Name MyRepoName -ErrorAction Stop | Set-HPOVExternalRepository -Certificate $UpdatedSslCertificate

Modify an existing repository with new Base64 SSL public certificate.

HPE OneView 4.00 Library