Update-AzStorageFileServiceProperty
Azure Storage File サービスのサービス プロパティを変更します。
構文
Update-AzStorageFileServiceProperty
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzStorageFileServiceProperty
-StorageAccount <PSStorageAccount>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-AzStorageFileServiceProperty
[-ResourceId] <String>
[-EnableShareDeleteRetentionPolicy <Boolean>]
[-ShareRetentionDays <Int32>]
[-EnableSmbMultichannel <Boolean>]
[-SmbProtocolVersion <String[]>]
[-SmbAuthenticationMethod <String[]>]
[-SmbChannelEncryption <String[]>]
[-SmbKerberosTicketEncryption <String[]>]
[-CorsRule <PSCorsRule[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Update-AzStorageFileServiceProperty コマンドレットは、Azure Storage File サービスのサービス プロパティを変更します。
例
例 1: ファイル共有の論理的な削除を有効にする
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableShareDeleteRetentionPolicy $true -ShareRetentionDays 5
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : False
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :このコマンドを実行すると、保持日数が 5 のファイル共有の論理的な削除が有効になります
例 2: Smb マルチチャネルを有効にする
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableSmbMultichannel $true
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :このコマンドにより、プレミアム FileStorage アカウントでのみサポートされる Smb マルチチャネルが有効になります。
例 3: セキュリティで保護された smb 設定を更新する
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" `
-SMBProtocolVersion SMB2.1,SMB3.0,SMB3.1.1 `
-SMBAuthenticationMethod Kerberos,NTLMv2 `
-SMBKerberosTicketEncryption RC4-HMAC,AES-256 `
-SMBChannelEncryption AES-128-CCM,AES-128-GCM,AES-256-GCM
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions : {SMB2.1, SMB3.0, SMB3.1.1}
ProtocolSettings.Smb.AuthenticationMethods : {Kerberos, NTLMv2}
ProtocolSettings.Smb.KerberosTicketEncryption : {RC4-HMAC, AES-256}
ProtocolSettings.Smb.ChannelEncryption : {AES-128-CCM, AES-128-GCM, AES-256-GCM}このコマンドは、セキュリティで保護された SMB 設定を更新します。
例 4: セキュリティで保護された SMB 設定をクリアする
Update-AzStorageFileServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" `
-SMBProtocolVersion @() `
-SMBAuthenticationMethod @() `
-SMBKerberosTicketEncryption @() `
-SMBChannelEncryption @()
StorageAccountName : mystorageaccount
ResourceGroupName : myresourcegroup
ShareDeleteRetentionPolicy.Enabled : True
ShareDeleteRetentionPolicy.Days : 5
ProtocolSettings.Smb.Multichannel.Enabled : True
ProtocolSettings.Smb.Versions :
ProtocolSettings.Smb.AuthenticationMethods :
ProtocolSettings.Smb.KerberosTicketEncryption :
ProtocolSettings.Smb.ChannelEncryption :このコマンドは、セキュリティで保護された SMB 設定をクリアします。
例 5: CORS 規則を更新する
$CorsRules = (@{
AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
ExposedHeaders=@();
AllowedOrigins=@("*");
AllowedMethods=@("TRACE","CONNECT")},
@{
AllowedOrigins=@("http://www.fabrikam.com","http://www.contoso.com");
ExposedHeaders=@("x-ms-meta-data*","x-ms-meta-customheader");
AllowedHeaders=@("x-ms-meta-target*","x-ms-meta-customheader");
MaxAgeInSeconds=30;
AllowedMethods=@("PUT")})
$property = Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule $CorsRules
$property.Cors.CorsRulesProperty
AllowedOrigins : {*}
AllowedMethods : {TRACE, CONNECT}
MaxAgeInSeconds : 0
ExposedHeaders : {}
AllowedHeaders : {x-ms-blob-content-type, x-ms-blob-content-disposition}
AllowedOrigins : {http://www.fabrikam.com, http://www.contoso.com}
AllowedMethods : {PUT}
MaxAgeInSeconds : 30
ExposedHeaders : {x-ms-meta-customheader, x-ms-meta-data*}
AllowedHeaders : {x-ms-meta-customheader, x-ms-meta-target*}最初のコマンドは、ルールの配列を$CorsRules変数に割り当てます。 このコマンドでは、標準を使用して、このコード ブロック内の複数の行に拡張します。 2 番目のコマンドは、$CorsRulesの規則をストレージ アカウントの File サービスに設定します。
例 6: CORS 規則をクリーンアップする
Update-AzStorageFileServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()このコマンドは、パラメーター CorsRule に @() を入力することで、ストレージ アカウントの CORS 規則をクリーンします。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CorsRule
ファイル サービスの CORS 規則を指定します。
| Type: | PSCorsRule[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableShareDeleteRetentionPolicy
$trueに設定してストレージ アカウントの共有削除アイテム保持ポリシーを有効にし、$falseに設定して共有削除アイテム保持ポリシーを無効にします。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSmbMultichannel
$trueに設定してマルチチャネルを有効にし、$falseに設定してマルチチャネルを無効にします。 プレミアム FileStorage にのみ適用されます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
リソース グループ名。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceId
ストレージ アカウントのリソース ID、またはファイル サービスプロパティのリソース ID を入力します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ShareRetentionDays
共有 DeleteRetentionPolicy の保持日数を設定します。 この値は、共有の削除アイテム保持ポリシーを有効にした場合にのみ設定する必要があります。
| Type: | Int32 |
| Aliases: | Days, RetentionDays |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SmbAuthenticationMethod
サーバーでサポートされる S MB (メガバイト) 認証方法を取得または設定します。 有効な値は NTLMv2、Kerberos です。
| Type: | String[] |
| Accepted values: | Kerberos, NTLMv2 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SmbChannelEncryption
サーバーでサポートされる S MB (メガバイト) チャネル暗号化を取得または設定します。 有効な値は、AES-128-CCM、AES-128-GCM、AES-256-GCM です。
| Type: | String[] |
| Accepted values: | AES-128-CCM, AES-128-GCM, AES-256-GCM |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SmbKerberosTicketEncryption
サーバーでサポートされる Kerberos チケット暗号化を取得または設定します。 有効な値は RC4-HMAC、AES-256 です。
| Type: | String[] |
| Accepted values: | AES-256, RC4-HMAC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SmbProtocolVersion
サーバーでサポートされている S MB (メガバイト) プロトコル バージョンを取得または設定します。 有効な値は、S MB (メガバイト)2.1、S MB (メガバイト)3.0、S MB (メガバイト)3.1.1 です。
| Type: | String[] |
| Accepted values: | SMB2.1, SMB3.0, SMB3.1.1 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageAccount
ストレージ アカウント オブジェクト
| Type: | PSStorageAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountName
ストレージ アカウント名。
| Type: | String |
| Aliases: | AccountName, Name |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示