Win32_Share クラスの SetShareInfo メソッド

SetShareInfoWMI クラス メソッドは、共有リソースのパラメーターを設定します。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

パラメーター

MaximumAllowed [in, optional]

このリソースを同時に使用できるユーザーの最大数に制限します。

例: 10。 このパラメーターは省略可能です。

説明 [入力、省略可能]

共有されているリソースを説明する省略可能なコメント。

Access [in, optional]

ユーザー レベルのアクセス許可のセキュリティ記述子。 セキュリティ記述子には、リソースのアクセス許可、所有者、およびアクセス機能に関する情報が含まれています。 詳細については、「 Win32_SecurityDescriptor」を参照してください。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示すその他の値を返します。

成功 (0)

アクセスが拒否されました (2)

不明なエラー (8)

無効な名前 (9)

無効なレベル (10)

無効なパラメーター (21)

共有の重複 (22)

リダイレクトされたパス (23)

不明なデバイスまたはディレクトリ (24)

ネット名が見つかりません (25)

その他 (26 4294967295)

注釈

SetShareInfo メソッドは動的オブジェクト メソッドであり、このクラスの出現時に使用されます。

Administrators または Account Operators ローカル グループのメンバー、または Communication、Print、または Server オペレーター グループ メンバーシップを持つメンバーのみが 、SetShareInfo を正常に実行できます。 印刷オペレーターは、プリンター・キューのみを設定できます。 Communication オペレーターは、通信デバイスのキューのみを設定できます。

例

次の PowerShell サンプルでは、 newShare 共有の名前を更新します。

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

要件

こちらもご覧ください

オペレーティング システム クラス

Win32_Share