Set-Acl

Module: Microsoft.PowerShell.Security

Syntax

Set-Acl <String> <Object> >] >] 

Set-Acl <PSObject> <Object> >] >] 

Set-Acl -LiteralPath <String> <Object> >] >] 

Description

Set-Aclコマンドレットは、ファイルまたはレジストリ キーなどの指定された項目のセキュリティ記述を、指定したセキュリティ記述子の値と一致するように変更します。Set-Acl を使用するには、Path または InputObject パラメータを使用して、セキュリティ記述子を変更する項目を特定します。 次に、AclObject または SecurityDescriptor パラメータを使用して、適用したい値を持つセキュリティ記述子を指定します。 Set-Acl は、提供された securitydescriptor を適用します。

Examples

Example 1: Copy a security descriptor from one file to another

$DogACL = Get-Acl -Path "C:\Dog.txt"Set-Acl -Path "C:\Cat.txt" -AclObject $DogACL

The these commands copy the values from the security descriptor of the Dog.txt file to the securitydescriptor of the Cat.txt file.は、AclObjectパラメータの値をモデルとして、その項目のセキュリティディスクリプタをAclObjectパラメータに一致させるために変更する。

最初のコマンドは、Get-Aclコマンドレットを使用して、Dog.txtファイルのセキュリティディスクリプタを取得します。代入演算子 (=) は、セキュリティ記述子を変数 $DogACL の値に格納します。

2番目のコマンドは、Set-Acl を使用して Cat.txt の ACL の値を $DogACL の値に変更します。

Pathパラメータの値は Cat.txt ファイルへのパスとします。 AclObjectparameterの値は、モデルのACL、この場合は$DogACL変数に保存されたDog.txtのACLです。

例 2: パイプライン演算子を使用して記述子を渡す

Get-Acl -Path "C:\Dog.txt" | Set-Acl -Path "C:\Cat.txt"

このコマンドは、アピライン演算子 (|) を使用して、Get-Acl コマンドから Set-Acl コマンドにセキュリティ記述子を送信する以外は、前の例のコマンドとほとんど同じです。

最初のコマンドは、Get-Acl コマンドレットを使用して Dog.txt ファイルにあるセキュリティ記述子を取得します。 パイプライン演算子 (|) は、Dog.txt のセキュリティ記述子を表すオブジェクトを Set-Acl コマンドレットに渡します。

2番目のコマンドは、Set-Acl を使用して Dog.txt のセキュリティ記述子を Cat.txt に適用します。コマンドが完了すると、Dog.txt と Cat.txt ファイルの ACL は同一になります。

例 3: セキュリティ記述子を複数のファイルに適用する

$NewAcl = Get-Acl File0.txtGet-ChildItem -Path "C:\temp" -Recurse -Include "*.txt" -Force | Set-Acl -AclObject $NewAcl

これらのコマンドは、File0.txt にあるセキュリティ記述子を適用します。

パイプラインの最初のコマンドは、C:\Tempディレクトリとそのすべてのサブディレクトリにあるすべてのテキスト ファイルに File0.txt ファイルのセキュリティ記述子を取得し、割り当て演算子 (=) を使用してそれを $NewACL 変数に格納します。 Recurseパラメーターは、コマンドをC:\tempのすべてのサブディレクトリに拡張します。 Includeパラメータは、取得するファイルを.txtファイル名拡張子を持つファイルに制限します。 Force パラメータは、他の方法では除外される隠しファイルを取得します。 (Recurse パラメーターはファイルではなくディレクトリで動作するため、c:\temp\*.txt は使用できません。)

パイプライン演算子 (|) は、取得したファイルを表すオブジェクトを Set-Aclcmdlet に送信し、パイプライン内のすべてのファイルに対して AclObject パラメーター内のセキュリティ記述子が適用されます。 この場合、パイプラインの 2 番目のコマンドは Set-Acl -AclObject $NewAcl -WhatIf となります。 このコマンドは、コマンドによって影響を受けるファイルを一覧表示します。

Example 4: Disable inheritance and preserve inherited access rules

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"$isProtected = $true$preserveInheritance = $true$NewAcl.SetAccessRuleProtection($isProtected, $preserveInheritance)Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

These commands are disable access inheritance from parent folders, but still preserving the existing inherited access rules.WhatIf parameterなしでコマンドを再度実行することができます。

最初のコマンドは、Get-Acl コマンドレットを使用して Dog.txt ファイルのセキュリティ記述子を取得します。

次に、継承されたアクセス規則を明示的なアクセス規則に変換するための変数が作成されます。 これに関連するアクセス規則を継承から保護するには、$isProtected 変数を$true に設定します。継承を許可するには、$isProtected を $false に設定します。 詳しくは，アクセス規則の保護設定を参照してください。$preserveInheritance変数に$trueを設定すると，継承されたアクセス規則を保持し，falseを設定すると継承されたアクセス規則を削除します。

最後のコマンドは、Set-Acl を使用して Dog.txt にセキュリティ記述子を適用します。 コマンドが完了すると、Petsフォルダから継承されたDog.txtのACLがDog.txtに直接適用され、Petsに追加された新しいアクセスポリシーはDog.txtへのアクセスを変更しません。

Example 5: Grant Administrators Full Control of the file

$NewAcl = Get-Acl -Path "C:\Pets\Dog.txt"# Set properties$identity = "BUILTIN\Administrators"$fileSystemRights = "FullControl"$type = "Allow"# Create new rule$fileSystemAccessRuleArgumentList = $identity, $fileSystemRights, $type$fileSystemAccessRule = New-Object -TypeName System.Security.AccessControl.FileSystemAccessRule -ArgumentList $fileSystemAccessRuleArgumentList# Apply new rule$NewAcl.SetAccessRule($fileSystemAccessRule)Set-Acl -Path "C:\Pets\Dog.txt" -AclObject $NewAcl

This command will grant the BUILTINAdministrators group Full control of the Dog.txt.このコマンドは、Dogsフォルダを管理するBUILTINAの管理者グループにDoug.txtのフルコントロールを許可します。

最初のコマンドは、Get-Aclコマンドレットを使用してDog.txtファイルのセキュリティ記述子を取得します。

次に、BUILTINAdministratorsグループにDog.txtファイルのフルコントロールを許可するための変数が作成されます。 $identity 変数には、ユーザー・アカウントの名前が設定されています。 FullControlに設定された$fileSystemRights変数には、アクセスルールに関連する操作の種類を指定するFileSystemRights値のいずれかを指定することができる。 $type 変数に “Allow” を設定し、操作を許可するか拒否するかを指定する。 $fileSystemAccessRuleArgumentList 変数は、新しい FileSystemAccessRule オブジェクトを作成するときに渡される引数リストである。

最後のコマンドは、Set-Acl を使用して Dog.txt にセキュリティ記述子を適用します。 このコマンドが完了すると、BUILTINaceousAdministratorsグループがDog.txtを完全に制御できるようになります。

Parameters

cmdlet 実行前に確認のためプロンプトが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
初期値です。	False
Accept pipeline input:	False
Accept wildcard characters.Noteは、ワイルドカード文字を受け付けないようにします。	False

-Exclude

指定した項目を省く。 このパラメータの値は，Pathパラメータを修飾します。 *.txtのようなapath要素またはパターンを入力します。 ワイルドカードも使用可能です。

Type:	String
Position:	Named
初期値：	なし
パイプライン入力に許可します。	False
Accept Wildcard characters:	True

-Filter

プロバイダの形式または言語でのフィルタを指定します。 このパラメータの値はPathパラメータを修飾します。 ワイルドカードの使用を含むフィルタの構文は、プロバイダに依存します。 フィルタは、他のパラメータよりも効率的です。なぜなら、オブジェクトを取得した後に PowerShell がオブジェクトをフィルタリングするのではなく、オブジェクトを取得するときにプロバイダがフィルタを適用するからです。

Type:	String
Position:	Named
初期値：	None
パイプライン入力に同意します。	False
Accept wildcard characters:	True

-Include

-InputObject

指定した項目のセキュリティ記述子を変更します。 Path とは異なり、LiteralPath パラメータの値は、入力されたとおりに使用されます。 ワイルドカードとして解釈される文字はありません。 一重引用符は、PowerShell にいかなる文字もエスケープシーケンスとして解釈しないように指示します。

このパラメーターは Windows PowerShell 3.0 で導入されました。

Type:	String
Aliases:	PSPath
Position:	Named
デフォルト値：	None
パイプライン入力を受け付けます。	True
Accept wildcard characters:	False

コマンドレットが実行するとどうなるか表示されます。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi	Position:	Named
初期値です。	False
Accept pipeline input:	False
Accept wildcard characters:	False