Register-SmisProvider
Registers an SMI-S provider and stores the configuration in the SMI-S service.
Syntax
Default (Default)
Register-SmisProvider
[-ConnectionUri] <Uri>
[-Credential] <PSCredential>
[[-AdditionalUsers] <String[]>]
[[-CimSession] <CimSession>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
Examples
Example 1: Register an SMI-S provider
PS C:\> Register-SmisProvider -ConnectionUri https://smis.contoso.com:5989
This command registers an SMI-S provider by using a URI.
Example 2: Register an SMI-S WMI provider in an automated script
PS C:\> $Password = ConvertTo-SecureString "password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential "admin", $Password
PS C:\> Register-SmisProvider -ConnectionUri ContosoServer17 -Credential $Credential
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.
For more information, type Get-Help ConvertTo-SecureString.
The second command creates a new credential object by using the $Password variable and assigns the result to the variable $Credential.
The third command registers an SMI-S provider by using the variable $Credential.
Example 3: Discover the storage objects managed by a registered provider
PS C:\> Update-StorageProviderCache -Name "smis.contoso.com" -DiscoveryLevel Level3
This command discovers the managed objects under a registered SMI-S provider.
Parameters
-AdditionalUsers
Specifies an array of other users who can manage the SMI-S provider. The cmdlet stores the credentials, specified by the Credentials parameter, for the users that you specify.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Users |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
Parameter properties
| Type: | CimSession |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ConnectionUri
Specifies the URI of the SMI-S provider to register. For CIMXML-based providers, the format must include the protocol specifier. The parameter supports HTTPS and HTTP. The port number for such providers should also be specified. You can omit default SMI-S ports, which are 5989 for HTTPS and 5988 for HTTP. The ConnectionUri is the server name for SMI-S providers implemented as WMI providers.
Parameter properties
| Type: | Uri |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Uri |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Credential
Specifies the credentials used to for authentication with the SMI-S provider. The cmdlet stores the credentials for subsequent use.
Parameter properties
| Type: | PSCredential |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Creds |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Force
Forces the command to run without asking for user confirmation.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.