PowerShell Plugin Reference 8.6.x

You can use the XL Deploy PowerShell plugin to create extensions and plugins that require PowerShell scripts to be executed on the target platform.

This document provides information that is specific to this version of the PowerShell plugin. For general information about the plugin, refer to Introduction to the XL Deploy PowerShell plugin.

CI Reference

Configuration Item Overview

Deployables

CIDescription
powershell.BasePowerShellDeployable Description unavailable
powershell.BasePowerShellDeployableArchiveArtifact Description unavailable
powershell.BasePowerShellDeployableFileArtifact Description unavailable
powershell.BasePowerShellDeployableFolderArtifact Description unavailable

Deployeds

CIDescription
powershell.BaseExtensiblePowerShellDeployed Description unavailable
powershell.BasePowerShellDeployed Description unavailable
powershell.ExtensiblePowerShellDeployed Base class for all extensible PowerShell deployed resource configuration items.
powershell.ExtensiblePowerShellDeployedArtifact Base class for all extensible PowerShell deployed artifact configuration items.

Containers

CIDescription
powershell.BasePowerShellContainer Description unavailable

Configuration Item Details

powershell.BaseExtensiblePowerShellDeployed

Virtual Type
Type Hierarchy powershell.BasePowerShellDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfaces udm.Deployed, udm.EmbeddedDeployedContainer

Description unavailable

  Parent
 
 
container: CI<udm.Container>
The container on which this deployed runs.
  Public properties
 
 
deployable: CI<udm.Deployable>
The deployable that this deployed is derived from.
 
 
startOnCreate: BOOLEAN = true
If set to true, the start script will be executed if this deployed is being created.
 
 
stopOnDestroy: BOOLEAN = true
If set to true, the stop script will be executed if this deployed is being destroyed.
 
 
stopStartOnModify: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployed is being modified.
 
 
stopStartOnNoop: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployable is not being modified.
  Hidden properties
 
 
createOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the create step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
createOrder: INTEGER = 60
Order at which the create step will be executed.
 
 
createVerb: STRING = Create
Verb that is used to prefix the description for the create step.
 
 
destroyOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the destroy step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
destroyOrder: INTEGER = 40
Order at which the destroy step will be executed.
 
 
destroyVerb: STRING = Destroy
Verb that is used to prefix the description for the destroy step.
 
 
discoverOrder: INTEGER = 50
Order at which the discover step will be executed.
 
 
maxBatchSize: INTEGER = 100
Maximum number of steps in a batch.
 
 
modifyOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the modify step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
modifyOrder: INTEGER = 60
Order at which the modify step will be executed.
 
 
modifyVerb: STRING = Modify
Verb that is used to prefix the description for the modify step.
 
 
noopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the noop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
noopOrder: INTEGER = 50
Order at which the noop step will be executed.
 
 
noopVerb: STRING = Noop
Verb that is used to prefix the description for the noop step.
 
 
startOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the start step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
startOrder: INTEGER = 90
Order at which the start step will be executed.
 
 
startVerb: STRING = Start
Verb that is used to prefix the description for the start step.
 
 
stopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the stop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
stopOrder: INTEGER = 10
Order at which the stop script will be executed.
 
 
stopVerb: STRING = Stop
Verb that is used to prefix the description for the stop step.
 
 
batchSteps: BOOLEAN
If set to true, multiple steps at the same order will be batched together in one batch to improve performance over high-latency WinRM connections
 
 
boundConfigurationItems: SET_OF_CI<udm.ConfigurationItem>
The set of created CIs.
 
 
classpathResources: SET_OF_STRING
Additional classpath resources that should be uploaded to the working directory before executing the script.
 
 
createScript: STRING
PowerShell script invoked to create a resource (or deploy an artifact) on Windows.
 
 
destroyScript: STRING
PowerShell script invoked to destroy a resource (or undeploy an artifact) on Windows.
 
 
discoverScript: STRING
Script invoked to discover and inspect deployeds of this type.
 
 
exposePasswordPropertiesOnHosts: BOOLEAN
Whether to add the host password to the powershell variable values.
 
 
libraryScripts: LIST_OF_STRING
List of scripts to append to the the step script.
 
 
modifyScript: STRING
PowerShell script invoked to modify a resource (or an artifact) on Windows.
 
 
noopScript: STRING
PowerShell script invoked to noop a resource or an artifact on Windows.
 
 
startScript: STRING
PowerShell script invoked to start a resource of an artifact on Windows.
 
 
stopScript: STRING
PowerShell script invoked to stop a resource or an artifact on Windows.
 
 
useSidecarIniFile: BOOLEAN
Whether to use a sidecar '.ini' file to transfer the powershell variable values.

powershell.BasePowerShellContainer

Virtual Type
Type Hierarchy udm.BaseContainer >> udm.BaseConfigurationItem
Interfaces udm.Container, overthere.HostContainer, powershell.PowerShellContainer, udm.Taggable

Description unavailable

  Parent
 
 
host: CI<overthere.Host>
Host upon which the container resides
  Public properties
 
 
tags: SET_OF_STRING
If set, only deployables with the same tag will be automatically mapped to this container.
  Hidden properties
 
 
discoverOrder: INTEGER
Order at which the discover step will be executed.
 
 
deployedsToDiscover: SET_OF_STRING
Deployeds To Discover
 
 
discoverScript: STRING
Script invoked to inspect this container and discover deployeds on it.
 
 
libraryScripts: LIST_OF_STRING = [powershell/runtime/base.ps1]
List of scripts to append to the the step script.
 
 
powerShellPath: STRING = powershell
Power Shell Path

powershell.BasePowerShellDeployable

Virtual Type
Type Hierarchy udm.BaseDeployable >> udm.BaseConfigurationItem
Interfaces udm.Deployable, udm.Taggable

Description unavailable

  Public properties
 
 
tags: SET_OF_STRING
If set, this deployable will only be mapped automatically to containers with the same tag.
  Hidden properties
 
 
boundTemplates: SET_OF_CI<udm.Template>
The set of CI templates.

powershell.BasePowerShellDeployableArchiveArtifact

Virtual Type
Type Hierarchy udm.BaseDeployableArchiveArtifact >> udm.BaseDeployableFileArtifact >> udm.BaseDeployableArtifact >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfaces udm.ArchiveArtifact, udm.Artifact, udm.Deployable, udm.DeployableArtifact, udm.FileArtifact, udm.SourceArtifact, udm.Taggable

Description unavailable

  Public properties
 
 
checksum: STRING
The checksum used to detect differences on the artifact. If not provided, it will be calculated by XL Deploy.
 
 
credentials: CI<credentials.Credentials>
Credentials of the URI.
 
 
excludeFileNamesRegex: STRING
Regular expression that matches file names that must be excluded from scanning
 
 
fileUri: STRING
The URI pointing to the (remote) location of the file this artifact represents
 
 
placeholders: SET_OF_STRING
Placeholders detected in this artifact
 
 
preScannedPlaceholders: BOOLEAN
Whether this artifact has been pre-scanned by the packager (ie. scanned for placeholders and checksum is set)
 
 
proxySettings: CI<credentials.ProxySettings>
Proxy Settings for artifact location
 
 
scanPlaceholders: BOOLEAN
Whether to scan this artifact to replace placeholders when it is imported
 
 
tags: SET_OF_STRING
If set, this deployable will only be mapped automatically to containers with the same tag.
  Hidden properties
 
 
textFileNamesRegex: STRING = .+\.(cfg | conf | config | ini | properties | props | txt | asp | aspx | htm | html | jsf | jsp | xht | xhtml | sql | xml | xsd | xsl | xslt)
Regular expression that matches file names of text files
 
 
boundTemplates: SET_OF_CI<udm.Template>
The set of CI templates.
 
 
delimiters: STRING = {{ }}
The delimiters used indicate placeholders, defaults to '{{ }}'. This is a 5 character string with a space in the middle, the first two are the leading delimiter, the last two are the closing delimiter
 
 
fileEncodings: MAP_STRING_STRING = { .+\.properties=ISO-8859-1 }
A map that maps regular expressions matching the full path of file(s) in the artifact to character set encodings

powershell.BasePowerShellDeployableFileArtifact

Virtual Type
Type Hierarchy udm.BaseDeployableFileArtifact >> udm.BaseDeployableArtifact >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfaces udm.Artifact, udm.Deployable, udm.DeployableArtifact, udm.FileArtifact, udm.SourceArtifact, udm.Taggable

Description unavailable

  Public properties
 
 
checksum: STRING
The checksum used to detect differences on the artifact. If not provided, it will be calculated by XL Deploy.
 
 
credentials: CI<credentials.Credentials>
Credentials of the URI.
 
 
excludeFileNamesRegex: STRING
Regular expression that matches file names that must be excluded from scanning
 
 
fileUri: STRING
The URI pointing to the (remote) location of the file this artifact represents
 
 
placeholders: SET_OF_STRING
Placeholders detected in this artifact
 
 
preScannedPlaceholders: BOOLEAN
Whether this artifact has been pre-scanned by the packager (ie. scanned for placeholders and checksum is set)
 
 
proxySettings: CI<credentials.ProxySettings>
Proxy Settings for artifact location
 
 
scanPlaceholders: BOOLEAN = true
Whether to scan this artifact to replace placeholders when it is imported
 
 
tags: SET_OF_STRING
If set, this deployable will only be mapped automatically to containers with the same tag.
  Hidden properties
 
 
textFileNamesRegex: STRING = .+\.(cfg | conf | config | ini | properties | props | txt | asp | aspx | htm | html | jsf | jsp | xht | xhtml | sql | xml | xsd | xsl | xslt)
Regular expression that matches file names of text files
 
 
boundTemplates: SET_OF_CI<udm.Template>
The set of CI templates.
 
 
delimiters: STRING = {{ }}
The delimiters used indicate placeholders, defaults to '{{ }}'. This is a 5 character string with a space in the middle, the first two are the leading delimiter, the last two are the closing delimiter
 
 
fileEncodings: MAP_STRING_STRING = { .+\.properties=ISO-8859-1 }
A map that maps regular expressions matching the full path of file(s) in the artifact to character set encodings

powershell.BasePowerShellDeployableFolderArtifact

Virtual Type
Type Hierarchy udm.BaseDeployableFolderArtifact >> udm.BaseDeployableArtifact >> udm.BaseDeployable >> udm.BaseConfigurationItem
Interfaces udm.Artifact, udm.Deployable, udm.DeployableArtifact, udm.FolderArtifact, udm.SourceArtifact, udm.Taggable

Description unavailable

  Public properties
 
 
checksum: STRING
The checksum used to detect differences on the artifact. If not provided, it will be calculated by XL Deploy.
 
 
credentials: CI<credentials.Credentials>
Credentials of the URI.
 
 
excludeFileNamesRegex: STRING
Regular expression that matches file names that must be excluded from scanning
 
 
fileUri: STRING
The URI pointing to the (remote) location of the file this artifact represents
 
 
placeholders: SET_OF_STRING
Placeholders detected in this artifact
 
 
preScannedPlaceholders: BOOLEAN
Whether this artifact has been pre-scanned by the packager (ie. scanned for placeholders and checksum is set)
 
 
proxySettings: CI<credentials.ProxySettings>
Proxy Settings for artifact location
 
 
scanPlaceholders: BOOLEAN = true
Whether to scan this artifact to replace placeholders when it is imported
 
 
tags: SET_OF_STRING
If set, this deployable will only be mapped automatically to containers with the same tag.
  Hidden properties
 
 
textFileNamesRegex: STRING = .+\.(cfg | conf | config | ini | properties | props | txt | asp | aspx | htm | html | jsf | jsp | xht | xhtml | sql | xml | xsd | xsl | xslt)
Regular expression that matches file names of text files
 
 
boundTemplates: SET_OF_CI<udm.Template>
The set of CI templates.
 
 
delimiters: STRING = {{ }}
The delimiters used indicate placeholders, defaults to '{{ }}'. This is a 5 character string with a space in the middle, the first two are the leading delimiter, the last two are the closing delimiter
 
 
fileEncodings: MAP_STRING_STRING = { .+\.properties=ISO-8859-1 }
A map that maps regular expressions matching the full path of file(s) in the artifact to character set encodings

powershell.BasePowerShellDeployed

Virtual Type
Type Hierarchy udm.BaseDeployed >> udm.BaseConfigurationItem
Interfaces udm.Deployed, udm.EmbeddedDeployedContainer

Description unavailable

  Parent
 
 
container: CI<udm.Container>
The container on which this deployed runs.
  Public properties
 
 
deployable: CI<udm.Deployable>
The deployable that this deployed is derived from.
  Hidden properties
 
 
discoverOrder: INTEGER = 50
Order at which the discover step will be executed.
 
 
boundConfigurationItems: SET_OF_CI<udm.ConfigurationItem>
The set of created CIs.
 
 
classpathResources: SET_OF_STRING
Additional classpath resources that should be uploaded to the working directory before executing the script.
 
 
discoverScript: STRING
Script invoked to discover and inspect deployeds of this type.
 
 
exposePasswordPropertiesOnHosts: BOOLEAN
Whether to add the host password to the powershell variable values.
 
 
libraryScripts: LIST_OF_STRING
List of scripts to append to the the step script.
 
 
useSidecarIniFile: BOOLEAN
Whether to use a sidecar '.ini' file to transfer the powershell variable values.

powershell.ExtensiblePowerShellDeployed

Virtual Type
Type Hierarchy powershell.BaseExtensiblePowerShellDeployed >> powershell.BasePowerShellDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfaces udm.Deployed, udm.EmbeddedDeployedContainer

Base class for all extensible PowerShell deployed resource configuration items.

  Parent
 
 
container: CI<udm.Container>
The container on which this deployed runs.
  Public properties
 
 
deployable: CI<udm.Deployable>
The deployable that this deployed is derived from.
 
 
startOnCreate: BOOLEAN = true
If set to true, the start script will be executed if this deployed is being created.
 
 
stopOnDestroy: BOOLEAN = true
If set to true, the stop script will be executed if this deployed is being destroyed.
 
 
stopStartOnModify: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployed is being modified.
 
 
stopStartOnNoop: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployable is not being modified.
  Hidden properties
 
 
createOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the create step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
createOrder: INTEGER = 60
Order at which the create step will be executed.
 
 
createVerb: STRING = Create
Verb that is used to prefix the description for the create step.
 
 
destroyOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the destroy step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
destroyOrder: INTEGER = 40
Order at which the destroy step will be executed.
 
 
destroyVerb: STRING = Destroy
Verb that is used to prefix the description for the destroy step.
 
 
discoverOrder: INTEGER = 50
Order at which the discover step will be executed.
 
 
maxBatchSize: INTEGER = 100
Maximum number of steps in a batch.
 
 
modifyOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the modify step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
modifyOrder: INTEGER = 60
Order at which the modify step will be executed.
 
 
modifyVerb: STRING = Modify
Verb that is used to prefix the description for the modify step.
 
 
noopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the noop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
noopOrder: INTEGER = 50
Order at which the noop step will be executed.
 
 
noopVerb: STRING = Noop
Verb that is used to prefix the description for the noop step.
 
 
startOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the start step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
startOrder: INTEGER = 90
Order at which the start step will be executed.
 
 
startVerb: STRING = Start
Verb that is used to prefix the description for the start step.
 
 
stopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the stop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
stopOrder: INTEGER = 10
Order at which the stop script will be executed.
 
 
stopVerb: STRING = Stop
Verb that is used to prefix the description for the stop step.
 
 
batchSteps: BOOLEAN
If set to true, multiple steps at the same order will be batched together in one batch to improve performance over high-latency WinRM connections
 
 
boundConfigurationItems: SET_OF_CI<udm.ConfigurationItem>
The set of created CIs.
 
 
classpathResources: SET_OF_STRING
Additional classpath resources that should be uploaded to the working directory before executing the script.
 
 
createScript: STRING
PowerShell script invoked to create a resource (or deploy an artifact) on Windows.
 
 
destroyScript: STRING
PowerShell script invoked to destroy a resource (or undeploy an artifact) on Windows.
 
 
discoverScript: STRING
Script invoked to discover and inspect deployeds of this type.
 
 
exposePasswordPropertiesOnHosts: BOOLEAN
Whether to add the host password to the powershell variable values.
 
 
libraryScripts: LIST_OF_STRING
List of scripts to append to the the step script.
 
 
modifyScript: STRING
PowerShell script invoked to modify a resource (or an artifact) on Windows.
 
 
noopScript: STRING
PowerShell script invoked to noop a resource or an artifact on Windows.
 
 
startScript: STRING
PowerShell script invoked to start a resource of an artifact on Windows.
 
 
stopScript: STRING
PowerShell script invoked to stop a resource or an artifact on Windows.
 
 
useSidecarIniFile: BOOLEAN
Whether to use a sidecar '.ini' file to transfer the powershell variable values.

powershell.ExtensiblePowerShellDeployedArtifact

Virtual Type
Type Hierarchy powershell.BaseExtensiblePowerShellDeployed >> powershell.BasePowerShellDeployed >> udm.BaseDeployed >> udm.BaseConfigurationItem
Interfaces udm.Artifact, udm.Deployed, udm.DerivedArtifact, udm.EmbeddedDeployedContainer

Base class for all extensible PowerShell deployed artifact configuration items.

  Parent
 
 
container: CI<udm.Container>
The container on which this deployed runs.
  Public properties
 
 
deployable: CI<udm.Deployable>
The deployable that this deployed is derived from.
 
 
placeholders: MAP_STRING_STRING
A Map containing all the placeholders mapped to their values. Special values are <ignore> or <empty>
 
 
startOnCreate: BOOLEAN = true
If set to true, the start script will be executed if this deployed is being created.
 
 
stopOnDestroy: BOOLEAN = true
If set to true, the stop script will be executed if this deployed is being destroyed.
 
 
stopStartOnModify: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployed is being modified.
 
 
stopStartOnNoop: BOOLEAN = true
If set to true, the stop and start scripts will be executed if this deployable is not being modified.
  Hidden properties
 
 
createOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the create step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
createOrder: INTEGER = 60
Order at which the create step will be executed.
 
 
createVerb: STRING = Create
Verb that is used to prefix the description for the create step.
 
 
destroyOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the destroy step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
destroyOrder: INTEGER = 40
Order at which the destroy step will be executed.
 
 
destroyVerb: STRING = Destroy
Verb that is used to prefix the description for the destroy step.
 
 
discoverOrder: INTEGER = 50
Order at which the discover step will be executed.
 
 
maxBatchSize: INTEGER = 100
Maximum number of steps in a batch.
 
 
modifyOptions: SET_OF_STRING = [uploadArtifactData, uploadClasspathResources]
Options for the modify step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
modifyOrder: INTEGER = 60
Order at which the modify step will be executed.
 
 
modifyVerb: STRING = Modify
Verb that is used to prefix the description for the modify step.
 
 
noopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the noop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
noopOrder: INTEGER = 50
Order at which the noop step will be executed.
 
 
noopVerb: STRING = Noop
Verb that is used to prefix the description for the noop step.
 
 
startOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the start step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
startOrder: INTEGER = 90
Order at which the start step will be executed.
 
 
startVerb: STRING = Start
Verb that is used to prefix the description for the start step.
 
 
stopOptions: SET_OF_STRING = [uploadClasspathResources]
Options for the stop step (1 or more of: none,uploadArtifactData,uploadClasspathResources,exposeDeployedApplication,exposePreviousDeployed).
 
 
stopOrder: INTEGER = 10
Order at which the stop script will be executed.
 
 
stopVerb: STRING = Stop
Verb that is used to prefix the description for the stop step.
 
 
batchSteps: BOOLEAN
If set to true, multiple steps at the same order will be batched together in one batch to improve performance over high-latency WinRM connections
 
 
boundConfigurationItems: SET_OF_CI<udm.ConfigurationItem>
The set of created CIs.
 
 
classpathResources: SET_OF_STRING
Additional classpath resources that should be uploaded to the working directory before executing the script.
 
 
createScript: STRING
PowerShell script invoked to create a resource (or deploy an artifact) on Windows.
 
 
destroyScript: STRING
PowerShell script invoked to destroy a resource (or undeploy an artifact) on Windows.
 
 
discoverScript: STRING
Script invoked to discover and inspect deployeds of this type.
 
 
exposePasswordPropertiesOnHosts: BOOLEAN
Whether to add the host password to the powershell variable values.
 
 
libraryScripts: LIST_OF_STRING
List of scripts to append to the the step script.
 
 
modifyScript: STRING
PowerShell script invoked to modify a resource (or an artifact) on Windows.
 
 
noopScript: STRING
PowerShell script invoked to noop a resource or an artifact on Windows.
 
 
startScript: STRING
PowerShell script invoked to start a resource of an artifact on Windows.
 
 
stopScript: STRING
PowerShell script invoked to stop a resource or an artifact on Windows.
 
 
useSidecarIniFile: BOOLEAN
Whether to use a sidecar '.ini' file to transfer the powershell variable values.