Select-PSUDeployment

Applies a deployment to the server.

SYNOPSIS

Applies a deployment to the server.

SYNTAX

Deployment

Select-PSUDeployment -Deployment <Deployment> [-Synchronous] [-Pin] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [<CommonParameters>]

Module

Select-PSUDeployment -ModuleName <String> -ModuleVersion <String> [-Synchronous] [-Pin]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

DESCRIPTION

Applies a deployment to the server. Pinning a deployment will set the server to read-only.

EXAMPLES

Example 1

PS C:\> Select-PSUDeployment -Deployment (Get-PSUDeployment -Name 'Production' -Version '2.0.0')

Applies the deployment with the name 'Production' and version '2.0.0'.

Example 2

PS C:\> Select-PSUDeployment -ModuleName 'MyModule' -ModuleVersion '1.0.0'

Applies the module with the name 'MyModule' and version '1.0.0'. The module must be stored in a repository that is configured in the server.

Example 3

PS C:\> Select-PSUDeployment -ModuleName 'MyModule' -ModuleVersion '1.0.0' -Pin

Applies the module with the name 'MyModule' and version '1.0.0'. The module must be stored in a repository that is configured in the server. The deployment will be pinned.

PARAMETERS

-AppToken

An application token to use for authentication.

Type: String
Parameter Sets: (All)
Aliases:

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

-ComputerName

The URL of the server to connect to.

Type: String
Parameter Sets: (All)
Aliases: Uri

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

-Credential

The credentials to use for authentication.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Deployment

The deployment to apply.

Type: Deployment
Parameter Sets: Deployment
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Integrated

For use when running within PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ModuleName

The name of the module that contains the deployment.

Type: String
Parameter Sets: Module
Aliases:

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

-ModuleVersion

The version of the module that contains the deployment.

Type: String
Parameter Sets: Module
Aliases:

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

-Pin

Pin the deployment.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Trust the certificate when connecting to the server.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Use the default credentials for the current user.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Synchronous

Wait for the deployment to complete before returning.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Cookies

Reuses and persists authentication cookies for the current PowerShell session.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable, and -ProgressAction. For more information, see about_CommonParameters.

INPUTS

PowerShellUniversal.Deployment

OUTPUTS

System.Object

NOTES

RELATED LINKS