Set-Acl

Set-Acl
    [-Path] <String[]>
    [-AclObject] <Object>
    [[-CentralAccessPolicy] <String>]
    [-ClearCentralAccessPolicy]
    [-Passthru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-Acl
    [-InputObject] <PSObject>
    [-AclObject] <Object>
    [-Passthru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-Acl
    [-AclObject] <Object>
    [[-CentralAccessPolicy] <String>]
    -LiteralPath <String[]>
    [-ClearCentralAccessPolicy]
    [-Passthru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Set-Acl コマンドレットは、指定したアイテムのセキュリティ記述子 (ファイルやレジストリ キーなど) を、指定したセキュリティ記述子の値と一致するように変更します。

Set-Aclを使用するには、Path または inputObject パラメーター を使用して、セキュリティ記述子を変更する項目を識別します。 次に、AclObject または SecurityDescriptor パラメーターを使用して、適用する値を持つセキュリティ記述子を指定します。 Set-Acl は、指定されたセキュリティ記述子を適用します。 AclObject パラメーターの値をモデルとして使用し、AclObject パラメーターの値と一致するように項目のセキュリティ記述子の値を変更します。

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

これらのコマンドは、Dog.txt ファイルのセキュリティ記述子から Cat.txt ファイルのセキュリティ記述子に値をコピーします。 コマンドが完了すると、Dog.txt ファイルと Cat.txt ファイルのセキュリティ記述子は同じです。

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

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

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

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

このコマンドは、前の例のコマンドとほぼ同じですが、パイプライン演算子を使用して Get-Aclcommand から Set-Acl コマンドにセキュリティ記述子を送信する点が異なります。

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

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

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

これらのコマンドは、File0.txt ファイル内のセキュリティ記述子を、C:\Temp ディレクトリとそのすべてのサブディレクトリ内のすべてのテキスト ファイルに適用します。

最初のコマンドは、現在のディレクトリ内の File0.txt ファイルのセキュリティ記述子を取得し、代入演算子 (=) を使用してそれを $NewACL 変数に格納します。

パイプラインの最初のコマンドでは、Get-ChildItem コマンドレットを使用して、C:\Temp ディレクトリ内のすべてのテキスト ファイルを取得します。 Recurse パラメーターは、コマンドを C:\temp のすべてのサブディレクトリに拡張します。Include パラメータは、取得するファイルをファイル名拡張子が ".txt" のファイルに限定します。 Force パラメーターは非表示のファイルを取得します。それ以外の場合は除外されます。 ("c:\temp*.txt" を使用することはできません。 これは、Recurse パラメーターがファイルではなくディレクトリに対して機能するためです。

パイプライン演算子 (|) は、取得したファイルを表すオブジェクトを Set-Acl コマンドレットに送信し、 AclObject パラメーターのセキュリティ記述子をパイプライン内のすべてのファイルに適用します。

実際には、WhatIf パラメーターを、複数の項目に影響を与える可能性があるすべての Set-Acl コマンドと共に使用することをお勧めします。 この場合、パイプラインの 2 番目のコマンドは "Set-Acl -AclObject $NewAcl -WhatIf" になります。 このコマンドは、コマンドの影響を受けるファイルを一覧表示します。 結果を確認したら、WhatIf パラメーターを せずにコマンドをもう一度実行できます。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

ACL オブジェクトまたはセキュリティ記述子を Set-Acl にパイプ処理できます。

既定では、Set-Acl は出力を生成しません。 ただし、 Passthru パラメーターを使用すると、セキュリティー・オブジェクトが生成されます。 セキュリティ オブジェクトの種類は、アイテムの種類によって異なります。

Set-Acl コマンドレットは、PowerShell ファイル システムとレジストリ プロバイダーによってサポートされています。 そのため、これを使用して、ファイル、ディレクトリ、およびレジストリ キーのセキュリティ記述子を変更できます。