New-AzureStorSimpleStorageAccountCredential
新增 Azure 記憶體存取認證。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager(ASM) API 的舊版 Azure 資源。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。 如需詳細資訊,請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager (ARM) 資源的建議 PowerShell 模組。
語法
New-AzureStorSimpleStorageAccountCredential
-StorageAccountName <String>
-StorageAccountKey <String>
-UseSSL <Boolean>
[-Endpoint <String>]
[-WaitForComplete]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
New-AzureStorSimpleStorageAccountCredential Cmdlet 會將 Azure 記憶體存取認證新增至 StorSimple 管理員,以供 StorSimple OneSDK Cmdlet 使用。 大部分 StorSimple OneSDK Cmdlet 都會處理最終系結至特定記憶體帳戶的實體,例如磁碟區、磁碟區容器、備份和備份原則。 對於某些 Cmdlet,您必須提供使用中記憶體帳戶的認證。 記憶體帳戶認證是在 OneSDK 中建立的存取物件,指向現有的 Azure 記憶體帳戶。 您可以提供現有記憶體帳戶的名稱和存取金鑰,以建立記憶體帳戶認證。 然後,您可以將該認證物件與其他 Cmdlet 搭配使用。
此 Cmdlet 會使用您在選取資源時所提供的註冊密鑰,方法是使用 Select-AzureStorSimpleResource Cmdlet。 請確定值正確,以避免加密失敗。 若要將註冊密鑰修改為正確的值,請使用 Select-AzureStorSimpleResource。
範例
範例 1:建立認證
PS C:\>New-AzureStorSimpleStorageAccountCredential -StorageAccountName "ContosoAccount07" -StorageAccountKey "L/eVcHtvqKjPWm5SaAJXtDlc0d69yVs0ICoZ2XIV1x0r9TqUyQyLUNS8lHvTvRmzdvQhJelav3fYyX7wyAu/SA==" -UseSSL $False -WaitForComplete
VERBOSE: ClientRequestId: f363cda4-54aa-4ee8-a3fa-00651ac86ffb_PS
VERBOSE: Found storage account with name : ContosoAccount07
VERBOSE: Storage credential verification succeeded.
VERBOSE: ClientRequestId: 716ce6df-62b3-4d48-8e0e-b0c94eec6934_PS
VERBOSE: Encryption in progress...
VERBOSE: ClientRequestId: 19aa4ef7-2789-4817-980c-19e33d257650_PS
JobId : 84f74c25-b742-452c-973c-43c7446e9f49
JobResult : Succeeded
JobStatus : Completed
ErrorCode :
ErrorMessage :
JobSteps : {}
VERBOSE: The job created for your create operation has completed successfully.
VERBOSE: ClientRequestId: 72bcdf37-bf06-4dac-adc9-31bb8d06475a_PS
CloudType : Azure
Hostname : blob.core.windows.net
InstanceId : b9986714-cef4-4c3f-a719-7acfc9559320
IsDefault : False
Location : West Europe
Login : ContosoAccount07
Name : ContosoAccount07
OperationInProgress : None
Password : G1sBQ6/qAN1gyRGRZVarpi7o6ToJl61sGugfeJ75yx7cwyaGLQHjrSEEwhxThbDJkxso2emAOarTe920Uufy
0AmJ9NpBI5hNyIFfwS4Ff+z2WmfKOzApyeofW5Zy7GPufehe/2ondq0XG4pGt3qxHFXNVUuiaPSU6TVWEKSh
hWDaksSXYMGij3DJdZDW1MA49e6Q7OY+rFujbYvi9P2OjVj8T+FbiMtMB5NnQEqE+t3k74RqPIDKU+d3h9x4
rYbAksGPfMvSa0fUipwYJ+Y5/NABA6j/MfB2pNDJbvqDoa1JCX6SKiwL81wmTh78/KnDY5ST3Said5DzKEbR
iYMQZg==
PasswordEncryptionCertThumbprint :
UseSSL : False
VolumeCount : 0
此命令會為指定的記憶體帳戶建立記憶體存取認證。 此命令會 指定 WaitForComplete 參數,因此 Cmdlet 會等候工作完成以將控制權傳回控制台。
範例 2:建立認證並查詢工作的狀態
PS C:\>New-AzureStorSimpleStorageAccountCredential -Name "ContosoAccount08" -Key "6BlMpSVrCQVQy3iOpkxiyY8uk/e3PiHIhadxV4qpPlKInr/eRFrGcWKDrfNC1IHj6oh0If/h3rALdZ0zuaf9cQ==" -UseSSL $True
PS C:\> Get-AzureStorSimpleTask -InstanceId "53816d8d-a8b5-4c1d-a177-e59007608d6d"
VERBOSE: ClientRequestId: 6104a834-ea57-4687-8e0b-1d97dc1c038b_PS
VERBOSE: Found storage account with name : ContosoAccount08
VERBOSE: Storage credential verification succeeded.
VERBOSE: ClientRequestId: 1f686fa4-5afc-43c3-87b6-f2da7bf9e65f_PS
VERBOSE: Encryption in progress...
VERBOSE: ClientRequestId: 8acb3770-bd72-43e6-9622-481002ad40b0_PS
53816d8d-a8b5-4c1d-a177-e59007608d6d
VERBOSE: The create task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
53816d8d-a8b5-4c1d-a177-e59007608d6d for tracking the task's status
第一個命令會為指定的記憶體帳戶建立記憶體存取認證。 命令會傳回工作識別碼。
第二個命令會使用 Get-AzureStorSimpleTask Cmdlet 來查詢工作的狀態。 命令會從第一個命令指定工作標識碼。
範例 3:建立要與另一個 Cmdlet 搭配使用的認證
PS C:\>Get-AzureStorSimpleStorageAccountCredential -Name "ContosoAccount09" | New-AzureStorSimpleDeviceVolumeContainer -Name "VC03" -DeviceName "Contoso63-AppVm" -BandWidthRate 256 -EncryptionEnabled $True -EncryptionKey "<your encryption key>" -WaitForComplete
VERBOSE: ClientRequestId: b1d1e637-cd72-4a1e-95a8-4db1d0b921a7_PS
VERBOSE: ClientRequestId: 71f56ca0-1f0b-4655-9331-4849e096345a_PS
VERBOSE: ClientRequestId: fbdd5a96-c95f-4547-9bcd-376d05543348_PS
VERBOSE: Storage Access Credential with name ContosoAccount09 found!
VERBOSE: ClientRequestId: b44e0363-9979-4e97-aeb1-d9eb4073a337_PS
VERBOSE: ClientRequestId: a6047943-b01e-44e4-a91d-5103aa80ce57_PS
VERBOSE: Encryption in progress...
VERBOSE: ClientRequestId: ac2dfd8b-922f-4e4d-8c8d-df1e2f87806c_PS
JobId : 1cf2db5d-624f-46c4-97b9-c36451ba144e
JobResult : Succeeded
JobStatus : Completed
ErrorCode :
ErrorMessage :
JobSteps : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}
VERBOSE: The job created for your create operation has completed successfully.
VERBOSE: ClientRequestId: 9558414b-0883-4cf6-8a02-40efc7edd80d_PS
BandwidthRate : 256
EncryptionKey : g53NTgCF3SBVZzzk+9yUz5nZopvZpNr3th92ol7WRO7ZUKhodPm7WNjjHEKB0/V+JY6P68tdaF4JxF5jH58e/
mCtTvnPNpOxykYFdY9GKGd9gnf+36sUPqiLFP+ONO5nN/N/zFmOeyuySsaa3gJsZG8eIiFc821yfe9m5QPbF
bx/Qyu8qLl1R1LrKU7k+46IXfwQYSyclztydyuzvFUUic9kaJuR3944VLvrjvxJIbnLrYy7hsn+Gfq7ds9NFq
AUILBH0+bk2uWgUlofAcE8fJ/rzDAHr8nFGWxOTJSrqAo0J3st8BN39+BcrY+zOWsMc/vKfc+Ss5PsGVGDT1r
eQ==
InstanceId : 60c34706-ef0c-4c6f-ad90-7249f42648f7
IsDefault : False
IsEncryptionEnabled : True
Name : VC03
OperationInProgress : None
Owned : True
PrimaryStorageAccountCredential : Microsoft.WindowsAzure.Management.StorSimple.Models.StorageAccountCredentialResponse
SecretsEncryptionThumbprint :
VolumeCount : 0
此命令會建立記憶體帳戶認證。 然後,命令會使用該認證傳遞至 New-AzureStorSimpleDeviceVolumeContainer Cmdlet,方法是使用管線運算符。 該 Cmdlet 會使用 認證來建立新的磁碟區容器。
參數
-Endpoint
指定記憶體帳戶的 Azure 記憶體端點。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Profile
指定 Azure 設定檔。
類型: | AzureSMProfile |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-StorageAccountKey
以純文字指定記憶體帳戶的存取金鑰。
類型: | String |
別名: | Key |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-StorageAccountName
指定現有記憶體帳戶的名稱。
類型: | String |
別名: | Name |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-UseSSL
指出在使用新的記憶體帳戶認證時,是否要使用 SSL 進行連線。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WaitForComplete
表示此 Cmdlet 會先等候作業完成,再將控制權傳回 Windows PowerShell 控制台。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
IEnumerable\<StorageAccountCredentialResponse\>, TaskResponse
如果您指定 WaitForComplet 參數,此 Cmdlet 會傳回 StorageAccountCredentialResponse 物件的清單。 如果您未指定該參數,Cmdlet 會 傳回 TaskResponse 物件。 StorageAccountCredentialResponse 包含下列屬性:
- CloudType (CloudType)
- 主機名稱 (字串)
- InstanceId (字串)
- IsDefault (布林值)
- 位置 (字串)
- 登入 (字串)
- 名稱 (字串)
- OperationInProgress (OperationInProgress)
- 密碼 (字串)
- PasswordEncryptionCertThumbprint (String)
- UseSSL (布林值)
- VolumeCount (int)