Update-NetworkController

Updates the Network Controller binaries.

Syntax

Update-NetworkController
      [-Update <UpdateType>]
      [-Force]
      [-ComputerName <String>]
      [-UseSsl]
      [-Credential <PSCredential>]
      [-CertificateThumbprint <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Update-NetworkController cmdlet updates the Network Controller binaries after a software update is installed or after the operating system is upgraded.

Network Controller automatically updates binaries after no longer than one hour. If you want the binaries to be updated immediately, run this cmdlet.

For this cmdlet to run, the software update has to be installed on all the computers in the Network Controller cluster. In case of an operating system upgrade, for this cmdlet to run, the operating system has to be upgraded on all computers in the Network Controller cluster.

Examples

Example 1

This command updates the Network Controller binaries on all the computers in the Network Controller cluster. Run this cmdlet on a Network Controller computer.

PS C:\> Update-NetworkController

Parameters

-CertificateThumbprint

Specifies the digital public key X.509 certificate of a user account that has permission to perform this action. Specify the certificate thumbprint of the certificate. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Specifies the name of the network controller node on which this cmdlet operates.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifies a user credential that has permission to perform this action. The default is the current user. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Update

Specifies the type of update. Valid values are:

  • Default. Compares the inbox version with the running version. Updates only if the inbox version is higher. Cluster and Service Fabric are updated only if the cluster was deployed through Install-NetworkController.

    This is the default update type.

  • Application. Updates only the application. Application is updated only if the inbox (template) version is higher than the running version.

  • Cluster. Updates only the cluster.

    If the cluster was installed through Install-NetworkController, the cluster and Service Fabric are updated only if the inbox version is higher than the installed version.

    If the cluster was not installed through Install-NetworkController, Service Fabric is updated only if the inbox (CAB) version is higher than the installed version.

    The manifest is always updated.

Type:UpdateType
Accepted values:Default, Application, Cluster
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSsl

Indicates that the remote computer uses the Secure Sockets Layer (SSL) protocol to establish a connection to the Network Controller node. The default value of this parameter is false. Specify this parameter only if you run this cmdlet on a computer that is not part of the network controller cluster.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

Object