Set-AzStorageAccount

模組:

Az.Storage

修改記憶體帳戶。

語法

Set-AzStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-StorageEncryption]
   [-AssignIdentity]
   [-UserAssignedIdentityId <String>]
   [-KeyVaultUserAssignedIdentityId <String>]
   [-KeyVaultFederatedClientId <String>]
   [-IdentityType <String>]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-EnableAzureActiveDirectoryDomainServicesForFile <Boolean>]
   [-EnableLargeFileShare]
   [-PublishMicrosoftEndpoint <Boolean>]
   [-PublishInternetEndpoint <Boolean>]
   [-AllowBlobPublicAccess <Boolean>]
   [-MinimumTlsVersion <String>]
   [-AllowSharedKeyAccess <Boolean>]
   [-SasExpirationPeriod <TimeSpan>]
   [-KeyExpirationPeriodInDay <Int32>]
   [-AllowCrossTenantReplication <Boolean>]
   [-DefaultSharePermission <String>]
   [-PublicNetworkAccess <String>]
   [-ImmutabilityPeriod <Int32>]
   [-ImmutabilityPolicyState <String>]
   [-EnableSftp <Boolean>]
   [-EnableLocalUser <Boolean>]
   [-AllowedCopyScope <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-RoutingChoice <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-KeyvaultEncryption]
   -KeyName <String>
   [-KeyVersion <String>]
   -KeyVaultUri <String>
   [-AssignIdentity]
   [-UserAssignedIdentityId <String>]
   [-KeyVaultUserAssignedIdentityId <String>]
   [-KeyVaultFederatedClientId <String>]
   [-IdentityType <String>]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-EnableAzureActiveDirectoryDomainServicesForFile <Boolean>]
   [-EnableLargeFileShare]
   [-PublishMicrosoftEndpoint <Boolean>]
   [-PublishInternetEndpoint <Boolean>]
   [-AllowBlobPublicAccess <Boolean>]
   [-MinimumTlsVersion <String>]
   [-AllowSharedKeyAccess <Boolean>]
   [-SasExpirationPeriod <TimeSpan>]
   [-KeyExpirationPeriodInDay <Int32>]
   [-AllowCrossTenantReplication <Boolean>]
   [-DefaultSharePermission <String>]
   [-PublicNetworkAccess <String>]
   [-ImmutabilityPeriod <Int32>]
   [-ImmutabilityPolicyState <String>]
   [-EnableSftp <Boolean>]
   [-EnableLocalUser <Boolean>]
   [-AllowedCopyScope <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-RoutingChoice <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-AssignIdentity]
   [-UserAssignedIdentityId <String>]
   [-KeyVaultUserAssignedIdentityId <String>]
   [-KeyVaultFederatedClientId <String>]
   [-IdentityType <String>]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-EnableLargeFileShare]
   [-PublishMicrosoftEndpoint <Boolean>]
   [-PublishInternetEndpoint <Boolean>]
   [-EnableAzureActiveDirectoryKerberosForFile <Boolean>]
   [-ActiveDirectoryDomainName <String>]
   [-ActiveDirectoryDomainGuid <String>]
   [-AllowBlobPublicAccess <Boolean>]
   [-MinimumTlsVersion <String>]
   [-AllowSharedKeyAccess <Boolean>]
   [-SasExpirationPeriod <TimeSpan>]
   [-KeyExpirationPeriodInDay <Int32>]
   [-AllowCrossTenantReplication <Boolean>]
   [-DefaultSharePermission <String>]
   [-PublicNetworkAccess <String>]
   [-ImmutabilityPeriod <Int32>]
   [-ImmutabilityPolicyState <String>]
   [-EnableSftp <Boolean>]
   [-EnableLocalUser <Boolean>]
   [-AllowedCopyScope <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-RoutingChoice <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-AssignIdentity]
   [-UserAssignedIdentityId <String>]
   [-KeyVaultUserAssignedIdentityId <String>]
   [-KeyVaultFederatedClientId <String>]
   [-IdentityType <String>]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-EnableLargeFileShare]
   [-PublishMicrosoftEndpoint <Boolean>]
   [-PublishInternetEndpoint <Boolean>]
   -EnableActiveDirectoryDomainServicesForFile <Boolean>
   [-ActiveDirectoryDomainName <String>]
   [-ActiveDirectoryNetBiosDomainName <String>]
   [-ActiveDirectoryForestName <String>]
   [-ActiveDirectoryDomainGuid <String>]
   [-ActiveDirectoryDomainSid <String>]
   [-ActiveDirectoryAzureStorageSid <String>]
   [-ActiveDirectorySamAccountName <String>]
   [-ActiveDirectoryAccountType <String>]
   [-AllowBlobPublicAccess <Boolean>]
   [-MinimumTlsVersion <String>]
   [-AllowSharedKeyAccess <Boolean>]
   [-SasExpirationPeriod <TimeSpan>]
   [-KeyExpirationPeriodInDay <Int32>]
   [-AllowCrossTenantReplication <Boolean>]
   [-DefaultSharePermission <String>]
   [-PublicNetworkAccess <String>]
   [-ImmutabilityPeriod <Int32>]
   [-ImmutabilityPolicyState <String>]
   [-EnableSftp <Boolean>]
   [-EnableLocalUser <Boolean>]
   [-AllowedCopyScope <String>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-RoutingChoice <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-AzStorageAccount Cmdlet 會修改 Azure 儲存體 帳戶。 您可以使用此 Cmdlet 來修改帳戶類型、更新客戶網域，或在儲存體帳戶上設定標籤。

範例

範例 1：設定記憶體帳戶類型

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -SkuName "Standard_RAGRS"

此命令會將記憶體帳戶類型設定為 Standard_RAGRS。

範例 2：設定記憶體帳戶的自訂網域

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -CustomDomainName "www.contoso.com" -UseSubDomain $true

此命令會設定記憶體帳戶的自定義網域。

範例 3：設定存取層值

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -AccessTier Cool

命令會將存取層值設定為非經常性存取層。

範例 4：設定自定義網域和標籤

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -CustomDomainName "www.domainname.com" -UseSubDomain $true -Tag @{tag0="value0";tag1="value1";tag2="value2"}

命令會設定記憶體帳戶的自定義網域和標籤。

範例 5：將加密金鑰來源設定為 Keyvault

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -AssignIdentity
$account = Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount"

$keyVault = New-AzKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
$key = Add-AzKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
Set-AzKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

# In case to enable key auto rotation, don't set KeyVersion
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

# In case to enable key auto rotation after set keyvault proeprites with KeyVersion, can update account by set KeyVersion to empty
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion "" -KeyVaultUri $keyVault.VaultUri

此命令會使用新建立的 Keyvault 來設定 Encryption KeySource。 如果想要啟用金鑰自動輪替，請勿在第一次設定 Keyvault 屬性時設定 Keyvault 屬性，或將 keyvault 屬性再次設定為空白來清除密鑰保存庫屬性。

範例 6：將加密密鑰來源設定為 “Microsoft.Storage”

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -StorageEncryption

此命令會將 Encryption KeySource 設定為 “Microsoft.Storage”

範例 7：使用 JSON 設定記憶體帳戶的 NetworkRuleSet 屬性

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -NetworkRuleSet (@{bypass="Logging,Metrics";
    ipRules=(@{IPAddressOrRange="20.11.0.0/16";Action="allow"},
            @{IPAddressOrRange="10.0.0.0/7";Action="allow"});
    virtualNetworkRules=(@{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1";Action="allow"},
                        @{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2";Action="allow"});
    defaultAction="allow"})

此命令會使用 JSON 設定記憶體帳戶的 NetworkRuleSet 屬性

範例 8：從記憶體帳戶取得 NetworkRuleSet 屬性，並將其設定為另一個記憶體帳戶

$networkRuleSet = (Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount").NetworkRuleSet 
Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount2" -NetworkRuleSet $networkRuleSet

第一個命令會從記憶體帳戶取得 NetworkRuleSet 屬性，而第二個命令會將它設定為另一個記憶體帳戶

範例 9：將類型為 “Storage” 或 “BlobStorage” 的記憶體帳戶升級為 “StorageV2” 類型記憶體帳戶

Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -UpgradeToStorageV2

命令會將類型為 「Storage」 或 「BlobStorage」 的記憶體帳戶升級為 「StorageV2」 類型記憶體帳戶。

範例 10：啟用 Azure 檔案儲存體 Microsoft Entra Domain Services 驗證並設定 DefaultSharePermission 來更新記憶體帳戶。

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -EnableAzureActiveDirectoryDomainServicesForFile $true -DefaultSharePermission StorageFileDataSmbShareContributor

$account.AzureFilesIdentityBasedAuth

DirectoryServiceOptions ActiveDirectoryProperties                                                      DefaultSharePermission      
----------------------- -------------------------                                                      ----------------------      
AADDS                   Microsoft.Azure.Commands.Management.Storage.Models.PSActiveDirectoryProperties StorageFileDataSmbShareContributor

命令會啟用 Azure 檔案儲存體 Microsoft Entra Domain Services 驗證來更新記憶體帳戶。

範例 11：啟用檔案 Active Directory 網域 服務驗證來更新記憶體帳戶，然後顯示 [檔案身分識別型驗證] 設定

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -EnableActiveDirectoryDomainServicesForFile $true `
        -ActiveDirectoryDomainName "mydomain.com" `
        -ActiveDirectoryNetBiosDomainName "mydomain.com" `
        -ActiveDirectoryForestName "mydomain.com" `
        -ActiveDirectoryDomainGuid "12345678-1234-1234-1234-123456789012" `
        -ActiveDirectoryDomainSid "S-1-5-21-1234567890-1234567890-1234567890" `
        -ActiveDirectoryAzureStorageSid "S-1-5-21-1234567890-1234567890-1234567890-1234" `
        -ActiveDirectorySamAccountName "samaccountname" `
        -ActiveDirectoryAccountType Computer 
		
$account.AzureFilesIdentityBasedAuth.DirectoryServiceOptions
AD

$account.AzureFilesIdentityBasedAuth.ActiveDirectoryProperties

DomainName        : mydomain.com
NetBiosDomainName : mydomain.com
ForestName        : mydomain.com
DomainGuid        : 12345678-1234-1234-1234-123456789012
DomainSid         : S-1-5-21-1234567890-1234567890-1234567890
AzureStorageSid   : S-1-5-21-1234567890-1234567890-1234567890-1234
SamAccountName    : samaccountname
AccountType       : Computer

命令會啟用 Azure 檔案儲存體 Active Directory 網域 服務驗證來更新記憶體帳戶，然後顯示 [檔案身分識別型驗證] 設定

範例 12：設定 MinimumTlsVersion、AllowBlobPublicAccess 和 AllowSharedKeyAccess

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -MinimumTlsVersion TLS1_1 -AllowBlobPublicAccess $false -AllowSharedKeyAccess $true

$account.MinimumTlsVersion
TLS1_1

$account.AllowBlobPublicAccess
False

$a.AllowSharedKeyAccess
True

命令會設定 MinimumTlsVersion、AllowBlobPublicAccess 和 AllowSharedKeyAccess，然後顯示帳戶的 3 個屬性

範例 13：使用 RoutingPreference 設定更新記憶體帳戶

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -PublishMicrosoftEndpoint $false -PublishInternetEndpoint $true -RoutingChoice InternetRouting

$account.RoutingPreference

RoutingChoice   PublishMicrosoftEndpoints PublishInternetEndpoints
-------------   ------------------------- ------------------------
InternetRouting                     False                     True

$account.PrimaryEndpoints

Blob               : https://mystorageaccount.blob.core.windows.net/
Queue              : https://mystorageaccount.queue.core.windows.net/
Table              : https://mystorageaccount.table.core.windows.net/
File               : https://mystorageaccount.file.core.windows.net/
Web                : https://mystorageaccount.z2.web.core.windows.net/
Dfs                : https://mystorageaccount.dfs.core.windows.net/
MicrosoftEndpoints : 
InternetEndpoints  : {"Blob":"https://mystorageaccount-internetrouting.blob.core.windows.net/","File":"https://mystorageaccount-internetrouting.file.core.windows.net/","Web":"https://mystorageaccount-internetrouting.z2.web.core.windows.net/","Dfs":"https://w
                     eirp3-internetrouting.dfs.core.windows.net/"}

此命令會使用 RoutingPreference 設定來更新記憶體帳戶：PublishMicrosoftEndpoint 為 false、PublishInternetEndpoint 為 true，以及 RoutingChoice 作為 MicrosoftRouting。

範例 14：使用 KeyExpirationPeriod 和 SasExpirationPeriod 更新記憶體帳戶

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -KeyExpirationPeriodInDay 5 -SasExpirationPeriod "1.12:05:06" -EnableHttpsTrafficOnly $true

$account.KeyPolicy.KeyExpirationPeriodInDays
5

$account.SasPolicy.SasExpirationPeriod
1.12:05:06

此命令會使用 KeyExpirationPeriod 和 SasExpirationPeriod 來更新記憶體帳戶，然後顯示更新的帳戶相關屬性。

範例 15：將記憶體帳戶更新為 Keyvault 加密，並使用使用者指派的身分識別存取 Keyvault

# Create KeyVault (no need if using exist keyvault)
$keyVault = New-AzKeyVault -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -Location eastus2euap -EnablePurgeProtection
$key = Add-AzKeyVaultKey -VaultName $keyvaultName -Name $keyname -Destination 'Software'

# create user assigned identity and grant access to keyvault (no need if using exist user assigned identity)
$userId = New-AzUserAssignedIdentity -ResourceGroupName $resourceGroupName -Name $userIdName
Set-AzKeyVaultAccessPolicy -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -ObjectId $userId.PrincipalId -PermissionsToKeys get,wrapkey,unwrapkey -BypassObjectIdValidation
$useridentityId= $userId.Id

# Update Storage account with Keyvault encryption and access Keyvault with user assigned identity, then show properties
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName `
                -IdentityType UserAssigned  -UserAssignedIdentityId $useridentityId  `
                -KeyVaultUri $keyVault.VaultUri -KeyName $keyname -KeyVaultUserAssignedIdentityId $useridentityId

$account.Encryption.EncryptionIdentity.EncryptionUserAssignedIdentity
/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuserid

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    : 
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 4/12/2021 8:17:57 AM

此命令會先建立keyvault和使用者指派的身分識別，然後使用keyvault加密來更新記憶體帳戶、具有使用者指派身分識別的記憶體存取密鑰保存庫。

範例 16：更新 Keyvault 加密的記憶體帳戶，從使用使用者指派的身分識別存取 Keyvault，以存取具有系統指派身分識別的 Keyvault

# Assign System identity to the account, and give the system assigned identity acces to the keyvault
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName  -IdentityType SystemAssignedUserAssigned
Set-AzKeyVaultAccessPolicy -VaultName $keyvaultName -ResourceGroupName $resourceGroupName -ObjectId $account.Identity.PrincipalId -PermissionsToKeys get,wrapkey,unwrapkey -BypassObjectIdValidation

# Update account from access Keyvault with user assigned identity to access Keyvault with system assigned identity
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -IdentityType SystemAssignedUserAssigned -KeyName $keyname -KeyVaultUri $keyvaultUri -KeyVaultUserAssignedIdentityId ""

# EncryptionUserAssignedIdentity is empty, so the account access keyvault with system assigned identity
$account.Encryption.EncryptionIdentity

EncryptionUserAssignedIdentity                                                                                                                 
------------------------------ 

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    : 
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 4/12/2021 8:17:57 AM

此命令會先將系統身分識別指派給帳戶，並授與系統指派的身分識別存取權給keyvault;然後更新記憶體帳戶，以使用系統指派的身分識別來存取 Keyvault。

範例 17：更新 Keyvault 和使用者指派的身分識別以存取 keyvault

# Update to another user assigned identity
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -IdentityType SystemAssignedUserAssigned -UserAssignedIdentityId $useridentity2 -KeyVaultUserAssignedIdentityId $useridentity2

# Update to encrypt with another keyvault
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName -KeyVaultUri $keyvaultUri2 -KeyName $keyname2 -KeyVersion $keyversion2

此命令會先更新使用者指派的身分識別以存取keyvault，然後更新keyvault以進行加密。 若要同時更新 Keyvault 和使用者指派的身分識別，我們需要使用上述 2 個步驟進行更新。

範例 18：使用 AllowCrossTenantReplication 更新記憶體帳戶

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -AllowCrossTenantReplication $false -EnableHttpsTrafficOnly $true

$account.AllowCrossTenantReplication

False

此命令會將 AllowCrossTenantReplication 設定為 false 來更新記憶體帳戶，然後顯示更新的帳戶相關屬性。

範例 18：啟用 PublicNetworkAccess 來更新記憶體帳戶

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -Name "mystorageaccount" -PublicNetworkAccess Enabled

$account.PublicNetworkAccess

Enabled

此命令會藉由將 PublicNetworkAccess 設定為已啟用來更新記憶體帳戶。

範例 19：更新帳戶層級不變性原則

$account = Set-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -ImmutabilityPeriod 2 -ImmutabilityPolicyState Unlocked

$account.ImmutableStorageWithVersioning.Enabled
True

$account.ImmutableStorageWithVersioning.ImmutabilityPolicy

ImmutabilityPeriodSinceCreationInDays State    
------------------------------------- -----    
                                    2 Unlocked

命令會更新現有記憶體帳戶上的帳戶層級不變性原則屬性，並顯示結果。 記憶體帳戶必須使用版本設定啟用帳戶層級不變性來建立。 帳戶層級不變性原則將會繼承並套用至物件層級沒有明確不變性原則的物件。

範例 20：啟用 Sftp 和 localuser 來更新記憶體帳戶

$account = Set-AzStorageAccount -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableSftp $true -EnableLocalUser $true 

$account.EnableSftp
True

$account.EnableLocalUser
True

此命令會啟用 Sftp 和 localuser 來更新記憶體帳戶。 若要順利執行命令，記憶體帳戶應該已經啟用階層式Namespace。

範例 21：使用另一個租使用者的 Keyvault 更新記憶體帳戶（使用 FederatedClientId 存取 Keyvault）

# create Storage account with Keyvault encryption (access Keyvault with FederatedClientId), then show properties
$account = Set-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName  `
                -KeyVaultUri $keyVault.VaultUri -KeyName $keyname -KeyVaultUserAssignedIdentityId $useridentityId -KeyVaultFederatedClientId $federatedClientId

$account.Encryption.EncryptionIdentity

EncryptionUserAssignedIdentity                                                                                                      EncryptionFederatedIdentityClientId                                                                                                                 
------------------------------                                                                                                      ----------------------------------- 
/subscriptions/{subscription-id}/resourceGroups/myresourcegroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myuserid ********-****-****-****-************

$account.Encryption.KeyVaultProperties

KeyName                       : wrappingKey
KeyVersion                    : 
KeyVaultUri                   : https://mykeyvault.vault.azure.net:443
CurrentVersionedKeyIdentifier : https://mykeyvault.vault.azure.net/keys/wrappingKey/8e74036e0d534e58b3bd84b319e31d8f
LastKeyRotationTimestamp      : 3/3/2022 2:07:34 AM

此命令會從另一個租使用者更新具有 Keyvault 的記憶體帳戶（使用 FederatedClientId 存取 Keyvault）。

參數

-AccessTier

指定此 Cmdlet 修改之記憶體帳戶的存取層。 此參數可接受的值為：經常性存取和非經常性存取。 如果您變更存取層，可能會導致額外費用。 如需詳細資訊，請參閱 Azure Blob 儲存體：經常性存取和非經常性存取儲存層。 如果記憶體帳戶的 Kind 為 StorageV2 或 BlobStorage，您可以指定 AccessTier 參數。 如果記憶體帳戶具有 Kind as Storage，請勿指定 AccessTier 參數。

類型:	String
接受的值:	Hot, Cool
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryAccountType

指定 Azure 儲存體的 Active Directory 帳戶類型。 可能的值包括：『User』、『Computer』。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryAzureStorageSid

指定 Azure 儲存體 的安全性識別碼 （SID）。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryDomainGuid

指定網域 GUID。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryDomainName

指定AD DNS 伺服器授權的主要網域。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryDomainSid

指定安全性識別碼 （SID）。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryForestName

指定要取得的 Active Directory 樹系。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectoryNetBiosDomainName

指定 NetBIOS 功能變數名稱。 當 -EnableActiveDirectoryDomainServicesForFile 設定為 true 時，必須設定此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ActiveDirectorySamAccountName

指定 Azure 儲存體的 Active Directory SAMAccountName。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowBlobPublicAccess

允許或不允許匿名存取記憶體帳戶中的所有 Blob 或容器。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowCrossTenantReplication

取得或設定允許或不允許跨Microsoft Entra 租用戶對象複寫。 此屬性的默認解譯為 true。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowedCopyScope

將限制複製至 Microsoft Entra 租使用者內的記憶體帳戶，或使用相同 VNet 的私人連結來回復制。 可能的值包括：'PrivateLink'、'AAD'

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowSharedKeyAccess

指出記憶體帳戶是否允許透過共用密鑰使用帳戶存取金鑰授權要求。 如果為 false，則所有要求，包括共用存取簽章，都必須使用 Microsoft Entra 標識符獲得授權。 默認值為 null，相當於 true。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AssignIdentity

產生並指派此儲存體帳戶的新記憶體帳戶身分識別，以搭配 Azure KeyVault 等密鑰管理服務使用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CustomDomainName

指定自訂網域的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultSharePermission

如果未指派 RBAC 角色，則使用 Kerberos 驗證的使用者預設共享許可權。

類型:	String
接受的值:	None, StorageFileDataSmbShareContributor, StorageFileDataSmbShareReader, StorageFileDataSmbShareElevatedContributor
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableActiveDirectoryDomainServicesForFile

為記憶體帳戶啟用 Azure 檔案儲存體 Active Directory 網域 服務驗證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-EnableAzureActiveDirectoryDomainServicesForFile

為記憶體帳戶啟用 Azure 檔案儲存體 Active Directory 網域 服務驗證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableAzureActiveDirectoryKerberosForFile

為記憶體帳戶啟用 Azure 檔案儲存體 Active Directory 網域 服務 Kerberos 驗證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableHttpsTrafficOnly

指出記憶體帳戶是否只啟用 HTTPS 流量。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableLargeFileShare

指出記憶體帳戶是否可以支援容量超過 5 TiB 的大型檔案共用。 啟用帳戶之後，就無法停用此功能。 目前僅支援 LRS 和 ZRS 複寫類型，因此無法將帳戶轉換成異地備援帳戶。 在 https://go.microsoft.com/fwlink/?linkid=2086047 中深入了解

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableLocalUser

啟用記憶體帳戶的本機使用者功能。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableSftp

啟用記憶體帳戶的安全檔案傳輸通訊協定。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

強制將變更寫入記憶體帳戶。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentityType

設定新的記憶體帳戶身分識別類型，idenetity 會與 Azure KeyVault 等密鑰管理服務搭配使用。

類型:	String
接受的值:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ImmutabilityPeriod

自建立原則后，容器中 Blob 的不變期間數天。 只有在使用 '-EnableAccountLevelImmutability' 建立帳戶時，才能變更此屬性。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ImmutabilityPolicyState

原則的模式。 可能的值包括：『Unlocked』、『Locked』、『Disabled。 停用狀態會停用原則。 解除鎖定狀態允許增加和減少不變性保留時間，也允許切換allowProtectedAppendWrites屬性。 鎖定狀態只允許增加不變性保留時間。 原則只能以 [已停用] 或 [解除鎖定] 狀態建立，而且可以在兩個狀態之間切換。 只有處於解除鎖定狀態的原則可以轉換為無法還原的鎖定狀態。 只有在使用 '-EnableAccountLevelImmutability' 建立帳戶時，才能變更此屬性。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyExpirationPeriodInDay

此帳戶的金鑰到期期間，對天數來說是正確的。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyName

如果使用 -KeyvaultEncryption 來啟用 金鑰保存庫 加密，請使用此選項指定 Keyname 屬性。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-KeyvaultEncryption

指出在使用記憶體服務加密時，是否要使用 Microsoft KeyVault 做為加密密鑰。 如果已設定 KeyName、KeyVersion 和 KeyVaultUri，則不論此參數是否已設定，KeySource 都會設定為 Microsoft.Keyvault。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyVaultFederatedClientId

將多租使用者應用程式的 ClientId 設定為與記憶體帳戶上跨租用戶客戶管理的金鑰伺服器端加密的使用者指派身分識別搭配使用。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyVaultUri

藉由指定 -KeyvaultEncryption 參數來使用 金鑰保存庫 加密時，請使用此選項來指定 金鑰保存庫 的 URI。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-KeyVaultUserAssignedIdentityId

為用來存取記憶體帳戶加密之 Azure KeyVault 的使用者指派身分識別設定資源識別碼，該標識碼必須位於記憶體帳戶的 UserAssignIdentityId 中。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-KeyVersion

藉由指定 -KeyvaultEncryption 參數來使用 金鑰保存庫 加密時，請使用此選項來指定密鑰版本的 URI。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MinimumTlsVersion

要求記憶體時允許的最低 TLS 版本。

類型:	String
接受的值:	TLS1_0, TLS1_1, TLS1_2
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定要修改的記憶體帳戶名稱。

類型:	String
別名:	StorageAccountName, AccountName
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-NetworkRuleSet

NetworkRuleSet 可用來定義防火牆和虛擬網路的組態規則集，以及設定網路屬性的值，例如允許略過規則的服務，以及如何處理不符合任何已定義規則的要求。

類型:	PSNetworkRuleSet
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicNetworkAccess

允許或不允許公用網路存取記憶體帳戶。可能的值包括：『Enabled』、『Disabled』。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublishInternetEndpoint

指出是否要發佈因特網路由記憶體端點

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublishMicrosoftEndpoint

指出是否要發佈 Microsoft 路由記憶體端點

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

指定要在其中修改記憶體帳戶的資源群組名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-RoutingChoice

路由選擇會定義使用者選擇的網路路由類型。 可能的值包括：'MicrosoftRouting'、'InternetRouting'

類型:	String
接受的值:	MicrosoftRouting, InternetRouting
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SasExpirationPeriod

此帳戶的 SAS 到期期間，是時間範圍且精確到秒數。

類型:	TimeSpan
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SkuName

指定記憶體帳戶的 SKU 名稱。 此參數可接受的值為：

• Standard_LRS - 本地備援記憶體。
• Standard_ZRS - 區域備援記憶體。
• Standard_GRS - 異地備援記憶體。
• Standard_RAGRS - 讀取許可權異地備援記憶體。
• Premium_LRS - 進階本地備援記憶體。
• Standard_GZRS - 異地備援區域備援記憶體。
• Standard_RAGZRS - 讀取許可權異地備援區域備援記憶體。 您無法將Standard_ZRS和Premium_LRS類型變更為其他帳戶類型。 您無法將其他帳戶類型變更為Standard_ZRS或Premium_LRS。

類型:	String
別名:	StorageAccountType, AccountType, Type
接受的值:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS, Standard_GZRS, Standard_RAGZRS
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-StorageEncryption

指出是否要將記憶體帳戶加密設定為使用Microsoft管理的密鑰。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

索引鍵/值組，格式為伺服器上設定為標籤的哈希表。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:	Hashtable
別名:	Tags
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-UpgradeToStorageV2

將記憶體帳戶種類從記憶體或 BlobStorage 升級至 StorageV2。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserAssignedIdentityId

為新的記憶體帳戶使用者指派的身分識別設定資源識別碼，身分識別將會與 Azure KeyVault 等密鑰管理服務搭配使用。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseSubDomain

指出是否啟用間接 CName 驗證。

類型:	Nullable<T>[Boolean]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

Hashtable

輸出

PSStorageAccount

相關連結

• Get-AzStorageAccount
• New-AzStorageAccount
• Remove-AzStorageAccount