|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Start-NcSystemImageInstall
NAME
Start-NcSystemImageInstall
SYNOPSIS
Start a software image fresh install.
SYNTAX
Start-NcSystemImageInstall [-Node] <String> [-Url] <String> [-NewName <Strin
g>] [-ReplacePackage] [-Controller <NcController[]>] [<CommonParameters>]
DESCRIPTION
Start a software image fresh install. For updating an image, use Start-NcSy
stemImageUpdate.
PARAMETERS
-Node <String>
This specifies the node on which the software image is located.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Url <String>
The location from which the software image is to be downloaded. The loca
tion can be specified in any of the following ways:
As an HTTP URL in the form http://[username[:password]@]host_name[:p
ort]/path_to_file. For instance, http://user:pass@example.com/downloads/
image.tgz. NOTE: The management utility does not check whether the Web
server is password protected; if a username and password are not provid
ed in the URL the command will nearly always fail with the error "Confir
mation needed"
As an FTP URL in the form ftp://host_name[:port]/path_to_file. For i
nstance, ftp://example.com/downloads/image.tgz.
As a TFTP URL in the form tftp://host_name[:port]/path_to_file. For
example, tftp://example.com/downloads/image.tgz. TFTP does not require a
user name or password.
As a path to a mounted file system in the form file://localhost/path
_to_file. For example, file://localhost/mroot/etc/software/image.tgz.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NewName <String>
Use this parameter to enter a package name that is different than the fi
le name in the URL.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ReplacePackage
If specified, the existing package is deleted and replaced with a new pa
ckage.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.C.Types.System.SystemImageUpdateProgress
NOTES
Category: system
API: system-image-install
Family: cluster
-------------- Example 1 --------------
C:\PS>Start-NcSystemImageInstall -Node fas3070cluster01-01 -Url http://examp
le.com/packages/image.tgz
Perform a fresh image install with the image located at http://example.com/p
ackages/image.tgz on node fas3070cluster01-01.
LastMessage : Downloading package. This may take up to 10 minutes.
RunStatus : Working
ExitStatus :
ExitMessage :
Phase : Download
RELATED LINKS
Get-NcSystemImageUpdateStatus
| Copyright © 2013 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|