Set-SPOContainerTypeConfiguration
SharePoint Embedded에서 컨테이너 형식의 구성 설정을 설정하거나 업데이트합니다.
구문
Default (기본값)
Set-SPOContainerTypeConfiguration
-ContainerTypeId <Guid>
[-DiscoverabilityDisabled <Boolean>]
[-SharingRestricted <Boolean>]
[-ApplicationRedirectUrl <String>]
[-WhoCanShareAnonymousAllowList <Guid[]>]
[-WhoCanShareAuthenticatedGuestAllowList <Guid[]>]
[-OverrideTenantWhoCanShareAnonymousAllowList <Boolean>]
[-OverrideTenantWhoCanShareAuthenticatedGuestAllowList <Boolean>]
[-CopilotEmbeddedChatHosts <System.Collections.Generic.List`1[System.String]>]
[-AnonymousLinkExpirationInDays <Int32>]
[-IsArchiveEnabled <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
전달된 매개 변수의 경우 cmdlet은 Set-SPOContainerTypeConfiguration SharePoint Embedded 애플리케이션에서 만든 컨테이너 유형에 대한 설정을 설정하거나 업데이트합니다.
이 cmdlet을 실행하려면 SharePoint Embedded 관리자여야 합니다.
예제
예 1
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $false
예제 1에서는 이 컨테이너 형식에 대한 검색 가능성을 설정합니다. 이 컨테이너 유형 내에서 만든 모든 콘텐츠는 office.com, onedrive.com, 권장 파일 및 기타 지능형 검색 환경을 포함하여 Microsoft 365 환경에서 검색할 수 있습니다.
예 2
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false
예제 2는 이 컨테이너 형식에 대해 열린 공유 모델을 켭니다. 편집 권한이 있는 모든 컨테이너 멤버 및 게스트 사용자는 컨테이너 유형 내에서 만든 파일을 공유할 수 있습니다.
예 3
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true -WhoCanShareAnonymousAllowList <guids>
예제 3은 테넌트 수준 WhoCanShareAnonymousAllowList를 재정의합니다.
예 4
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true –WhoCanShareAnonymousAllowList $null -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null
예제 4는 테넌트 수준 WhoCanShareAnonymousAllowList 및 WhoCanShareAuthenticatedGuestAllowList null 값을 재정의하여 검사 무시합니다. 이로 인해 더 이상 외부 공유 권한을 특정 보안 그룹의 구성원으로 제한하지 않습니다.
예 5
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null
예제 5는 그대로 유지하면서 null 값으로 테넌트 수준을 WhoCanShareAuthenticatedGuestAllowList 재정의 WhoCanShareAnonymousAllowList 합니다. 이렇게 하면 인증된 게스트에 대한 공유 권한을 더 이상 특정 보안 그룹의 구성원으로 제한하지 않습니다.
예 6
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
다음은 ID가 4f0af585-8dcc-0000-223d-661eb2c604e4인 컨테이너 형식의 호스트 URL을 설정하는 예제입니다.
예 7
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -IsArchiveEnabled $true
예제 7에서는 ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4의 모든 컨테이너에서 작업을 보관하고 다시 활성화할 수 있습니다.
매개 변수
-AnonymousLinkExpirationInDays
값이 설정된 후 생성된 모든 익명 링크가 설정된 일 수 후에 만료되게 지정합니다.
값은 1~730일이 될 수 있습니다.
테넌트 수준 설정을 연기하려면 값을 -1로 설정합니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ApplicationRedirectUrl
이 매개 변수는 애플리케이션을 리디렉션해야 하는 URL을 지정합니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ContainerTypeId
이 매개 변수는 SharePoint Embedded 애플리케이션에 해당하는 컨테이너 형식의 ID를 지정합니다.
매개 변수 속성
| 형식: | System.Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CopilotEmbeddedChatHosts
이 매개 변수는 SharePoint Embedded 애플리케이션의 선언적 에이전트 환경을 사용할 수 있는 호스트 URL을 추가하는 데 사용됩니다.
매개 변수 속성
| 형식: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DiscoverabilityDisabled
적용 가능: SharePoint Embedded
Microsoft 365의 SharePoint 관리자는 Microsoft 365 환경에서 콘텐츠가 표시되는 방식을 제어할 수 있습니다. 이 값이 true이면 SharePoint Embedded 애플리케이션 콘텐츠는 office.com, onedrive.com, 권장 섹션 또는 다른 Microsoft 지능형 파일 검색 기능을 통해 Microsoft 365 환경 전체에 숨겨집니다. Microsoft 365 환경을 옵트인하는 경우 파일이 Microsoft 365 환경에 통합되어 지능형 파일 검색에 참여하게 됩니다.
PARAMVALUE: True | False
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsArchiveEnabled
플래그를 -IsArchiveEnabled 사용하여 컨테이너 보관을 사용하도록 설정합니다. 보관은 데이터를 콜드 계층으로 이동하여 스토리지 비용을 줄입니다. 보관하는 동안 콘텐츠는 다시 활성화될 때까지 액세스할 수 없습니다. 다시 활성화는 처음 7일 이내에 즉시 수행되며 그 후 최대 24시간이 걸릴 수 있습니다. 이 플래그를 포함하지 않으면 기본값은 이며 모든 보관 API 호출은 실패합니다 False. 플래그를 업데이트한 후 사용 중인 테넌트에서 변경 내용이 적용되도록 최대 24시간을 허용합니다.
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-OverrideTenantWhoCanShareAnonymousAllowList
이 설정은 컨테이너 형식 WhoCanShareAnonymousAllowList 이 테넌트 수준 WhoCanShareAnonymousAllowList를 재정의하는지 여부를 결정합니다.
PARAMVALUE: True | False
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-OverrideTenantWhoCanShareAuthenticatedGuestAllowList
이 설정은 컨테이너 형식 WhoCanShareAuthenticatedGuestAllowList 이 테넌트 수준 WhoCanShareAuthenticatedGuestAllowList를 재정의하는지 여부를 결정합니다.
PARAMVALUE: True | False
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SharingRestricted
적용 가능: SharePoint Embedded
SharePoint Embedded는 개발자가 컨테이너 권한 역할에 따라 파일 공유 권한을 구성할 수 있는 역할 기반 공유 모델을 제공하여 제한적인 공유 모델과 개방형 공유 모델 중에서 선택할 수 있습니다. 열린 공유 모델을 사용하면 편집 권한이 있는 모든 컨테이너 멤버 및 게스트 사용자가 파일을 공유할 수 있습니다. 제한적인 공유 모델을 사용하면 소유자 또는 관리자인 컨테이너 멤버만 파일을 공유할 수 있습니다.
PARAMVALUE: True | False
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhoCanShareAnonymousAllowList
익명(인증되지 않은) 사용자 및 인증된 게스트 사용자와 공유할 수 있는 보안 그룹의 컨테이너 유형별 목록을 설정합니다. 와 함께 OverrideTenantWhoCanShareAnonymousAllowList설정해야 합니다.
참고
이 허용 목록은 보안 그룹만 허용하며 Microsoft 365 그룹 않습니다.
각 보안 그룹은 GUID 개체 ID로 표시됩니다. 이 목록을 특정 보안 그룹으로 설정하려면 해당 GUID를 매개 변수로 입력해야 합니다. 여러 GUID를 쉼표로 구분하여 입력할 수 있습니다. 검사 건너뛰고 모든 보안 그룹이 누구에게나 공유할 수 있도록 하려면 이 허용 목록과 를 WhoCanShareAuthenticatedGuestAllowList null 배열로 설정합니다.
매개 변수 속성
| 형식: | System.Guid[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhoCanShareAuthenticatedGuestAllowList
컨테이너 수준에서 인증된 게스트 사용자와 공유할 수 있는 보안 그룹의 컨테이너 유형별 목록을 설정합니다. 와 함께 OverrideTenantWhoCanShareAuthenticatedGuestAllowList설정해야 합니다.
참고
이 허용 목록은 보안 그룹만 허용하며 Microsoft 365 그룹 않습니다.
각 보안 그룹은 GUID 개체 ID로 표시됩니다. 이 목록을 특정 보안 그룹으로 설정하려면 해당 GUID를 매개 변수로 입력해야 합니다. 여러 GUID를 쉼표로 구분하여 입력할 수 있습니다. 검사 건너뛰고 모든 보안 그룹이 인증된 게스트와 공유할 수 있도록 하려면 이 허용 목록을 null 배열로 설정합니다.
매개 변수 속성
| 형식: | System.Guid[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.