Export (0) Print
Expand All

Register-SmisProvider

Updated: December 14, 2012

Applies To: Windows Server 2012

Register-SmisProvider

Registers an SMI-S provider and stores the configuration in the SMI-S service.

Syntax

Parameter Set: Default
Register-SmisProvider [-ConnectionUri] <Uri> [-Credential] <PSCredential> [[-AdditionalUsers] <String[]> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Register-SmisProvider cmdlet registers a Storage Management Initiative - Specification (SMI-S) provider. The cmdlet registers a provider identified by a Uniform Resource Identifier (URI), and stores the configuration and credentials for later use. In order to use a provider, you must register the provider with the SMI-S service.

When you register the provider, the credentials are stored for your use only. You can also specify other users to manage the registered provider.

To search for a list of SMI-S providers on the same subnet as your server, use the Search-SmisProvider cmdlet.

If the provider is using the HTTPS protocol, you may be prompted to accept the certificate if it has not been previously seen by your server.

Parameters

-AdditionalUsers<String[]>

Specifies an array of other users who can manage the SMI-S provider. The cmdlet stores the credentials , specified by the -Credentials parameter for users in the AdditionalUsers parameter.


Aliases

Users

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ConnectionUri<Uri>

Specifies the URI of the SMI-S provider to register. For CIMXML-based providers, the format must include the protocol specifier (HTTPS and HTTP are supported). The port number for such providers should also be specified, but can be omitted if the default SMI-S ports are used (5989 for HTTPS and 5988 for HTTP). The ConnectionUri is just the server name for SMI-S providers implemented as WMI providers.


Aliases

Uri

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies the credentials used to for authentication with the SMI-S provider. The cmdlet stores the credentials for subsequent use.


Aliases

Creds

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Force

Performs the action without a confirmation message.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Register an SMI-S provider

This command registers an SMI-S provider by using a URI.


PS C:\> Register-SmisProvider -ConnectionUri https://smis.contoso.com:5989

Example 2: Register an SMI-S WMI provider in an automated script

This example registers an SMI-S WMI provider.

The first command converts a string to a secure string and assigns the result to the variable $password.

The second command creates a new credential object by using the $password variable and assigns the result to the variable $cred.

The third command registers an SMI-S provider by using the variable $cred.


PS C:\> $password = ConvertTo-SecureString "p@ssword" -AsPlainText -Force 
PS C:\>$cred = New-Object System.Management.Automation.PSCredential "admin", $password
PS C:\>Register-SmisProvider -ConnectionUri ContosoServer1 -Credential $cred

Example 3: Discover the storage objects managed by a registered provider

This command discovers the managed objects under a registered SMI-S provider.


PS C:\> Update-StorageProviderCache -Name smis.contoso.com -DiscoveryLevel Level3

Related topics

Search-SmisProvider

Unregister-SmisProvider

Get-StorageProvider

Update-StorageProviderCache

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft